penguiflow 1.0.0__py3-none-any.whl → 1.0.2__py3-none-any.whl

penguiflow/__init__.py

@@ -40,4 +40,4 @@ __all__ = [
     "create",
 ]
 
-__version__ = "1.0.0"
+__version__ = "1.0.2"

penguiflow/core.py

@@ -288,6 +288,8 @@ class PenguiFlow:
             raise RuntimeError("PenguiFlow already running")
         self._running = True
         self._registry = registry
+        if registry is not None:
+            self._ensure_registry_covers_nodes(registry)
         loop = asyncio.get_running_loop()
 
         for node in self._nodes:
@@ -542,6 +544,26 @@ class PenguiFlow:
                     },
                 )
 
+    def _ensure_registry_covers_nodes(self, registry: ModelRegistry) -> None:
+        missing: list[str] = []
+        for node in self._nodes:
+            if node.policy.validate == "none":
+                continue
+            node_name = node.name
+            if node_name is None:
+                continue
+            try:
+                registry.adapters(node_name)
+            except KeyError:
+                missing.append(node_name)
+
+        if missing:
+            formatted = ", ".join(sorted(missing))
+            raise RuntimeError(
+                "ModelRegistry is missing entries for nodes requiring validation: "
+                f"{formatted}"
+            )
+
 
 PlaybookFactory = Callable[[], tuple["PenguiFlow", ModelRegistry | None]]
 

{penguiflow-1.0.0.dist-info → penguiflow-1.0.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: penguiflow
-Version: 1.0.0
+Version: 1.0.2
 Summary: Async agent orchestration primitives.
 Author: PenguiFlow Team
 License: MIT License
@@ -147,11 +147,13 @@ await flow.stop()
    * Flows are orchestrators, mostly I/O-bound.
    * Async tasks are cheap, predictable, and cancellable.
    * Heavy CPU work should be offloaded inside a node (process pool, Ray, etc.), not in PenguiFlow itself.
+   * v1 intentionally stays in-process; scaling out or persisting state will arrive with future pluggable backends.
 
 2. **Typed contracts.**
 
    * In/out models per node are defined with Pydantic.
    * Validated at runtime via cached `TypeAdapter`s.
+   * `flow.run(registry=...)` verifies every validating node is registered so misconfigurations fail fast.
 
 3. **Reliability first.**
 
@@ -331,6 +333,16 @@ flow focused on high-level orchestration logic.
 * **NodePolicy**: set validation scope plus per-node timeout, retries, and backoff curves.
 * **Structured logs**: enrich every node event with `{ts, trace_id, node_name, event, latency_ms, q_depth_in, attempt}`.
 * **Middleware hooks**: subscribe observers (e.g., MLflow) to the structured event stream.
+* See `examples/reliability_middleware/` for a concrete timeout + retry walkthrough.
+
+---
+
+## ⚠️ Current Constraints
+
+- **In-process runtime**: there is no built-in distribution layer yet. Long-running CPU work should be delegated to your own pools or services.
+- **Registry-driven typing**: nodes default to validation. Provide a `ModelRegistry` when calling `flow.run(...)` or set `validate="none"` explicitly for untyped hops.
+- **Observability**: structured logs + middleware hooks are available, but integrations with third-party stacks (OTel, Prometheus) are DIY for now.
+- **Roadmap**: v2 targets streaming, distributed backends, richer observability, and test harnesses. Contributions and proposals are welcome!
 
 ---
 

{penguiflow-1.0.0.dist-info → penguiflow-1.0.2.dist-info}/RECORD

@@ -1,13 +1,13 @@
-penguiflow/__init__.py,sha256=wT0yYO6DsV4x1uLwSXbhcXPP3g9YI9x3mcUWxhX5kis,874
-penguiflow/core.py,sha256=ljXFsmVtWj2UTCxWNok-ZRGrPho0wJN3OWP5IgnfhDU,20143
+penguiflow/__init__.py,sha256=BIBAYJZtOHQ7AZMBWD0g7d1RTCR9qWLQGwcUuKa5GMo,874
+penguiflow/core.py,sha256=fO5GXF7Hih-gEcUPbyXVJilgUmwbvd72j337r5oOWME,20908
 penguiflow/middlewares.py,sha256=LUlK4FrMScK3oaNSrAYNw3s4KcAZ716DTLAUqvsOkL8,319
 penguiflow/node.py,sha256=0NOs3rU6t1tHNNwwJopqzM2ufGcp82JpzhckynWBRqs,3563
 penguiflow/patterns.py,sha256=Ivuuy0on0OMsdYd5DRFZm1EgujXKPEaIIMH0ZWlJ1s0,4199
 penguiflow/registry.py,sha256=4lrGDMFjM7c8pfZFc_YG0YHg-F80JyF4c-j0UbAf150,1419
 penguiflow/types.py,sha256=QV2JvB_QnohfBATSaviPWm0HSR9B6dTc3UOwFIYyaqg,1154
 penguiflow/viz.py,sha256=_puIEJevq2DrfNuydm3DG1V1o4PgICxd5pA-Es_IyWY,112
-penguiflow-1.0.0.dist-info/licenses/LICENSE,sha256=JSvodvLXxSct_kI9IBsZOBpVKoESQTB_AGbkClwZ7HI,1065
-penguiflow-1.0.0.dist-info/METADATA,sha256=MhOA10s6CxVM1UbbKPMEkA9FKS-DJMLU7MEYG748g1U,12143
-penguiflow-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-penguiflow-1.0.0.dist-info/top_level.txt,sha256=F-5jgzPP4Mo_ErgtzGDFJdRT4CIfFjFBnxxcn-RpWBU,11
-penguiflow-1.0.0.dist-info/RECORD,,
+penguiflow-1.0.2.dist-info/licenses/LICENSE,sha256=JSvodvLXxSct_kI9IBsZOBpVKoESQTB_AGbkClwZ7HI,1065
+penguiflow-1.0.2.dist-info/METADATA,sha256=SBuhdqSVKIwo9_vVV2bW2IsmGiia84q59ESqHl8zgR0,13090
+penguiflow-1.0.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+penguiflow-1.0.2.dist-info/top_level.txt,sha256=F-5jgzPP4Mo_ErgtzGDFJdRT4CIfFjFBnxxcn-RpWBU,11
+penguiflow-1.0.2.dist-info/RECORD,,