flock-core 0.5.11__py3-none-any.whl → 0.5.21__py3-none-any.whl

flock/utils/visibility.py

@@ -0,0 +1,79 @@
+"""Visibility deserialization utilities."""
+
+from datetime import timedelta
+from typing import Any
+
+from flock.core.visibility import (
+    AfterVisibility,
+    LabelledVisibility,
+    PrivateVisibility,
+    PublicVisibility,
+    TenantVisibility,
+    Visibility,
+)
+
+
+class VisibilityDeserializer:
+    """Deserializes visibility from dict/str representation.
+
+    This utility eliminates 5+ duplicate visibility deserialization patterns
+    scattered across store.py, context_provider.py, and orchestrator.py.
+    """
+
+    @staticmethod
+    def deserialize(data: dict[str, Any] | str) -> Visibility:
+        """
+        Deserialize visibility from various formats.
+
+        Args:
+            data: Dict with 'kind' field or string
+
+        Returns:
+            Visibility instance
+
+        Raises:
+            ValueError: If visibility kind is unknown
+
+        Example:
+            >>> vis = VisibilityDeserializer.deserialize({"kind": "Public"})
+            >>> assert isinstance(vis, PublicVisibility)
+        """
+        if isinstance(data, str):
+            kind = data
+            props = {}
+        else:
+            kind = data.get("kind")
+            props = data
+
+        if kind == "Public":
+            return PublicVisibility()
+
+        if kind == "Private":
+            agents = set(props.get("agents", []))
+            return PrivateVisibility(agents=agents)
+
+        if kind == "Labelled":
+            required_labels = set(props.get("required_labels", []))
+            return LabelledVisibility(required_labels=required_labels)
+
+        if kind == "Tenant":
+            tenant_id = props.get("tenant_id")
+            return TenantVisibility(tenant_id=tenant_id)
+
+        if kind == "After":
+            ttl_value = props.get("ttl")
+            # Handle timedelta or raw seconds
+            if isinstance(ttl_value, (int, float)):
+                ttl = timedelta(seconds=ttl_value)
+            elif isinstance(ttl_value, dict):
+                # Pydantic dict representation
+                ttl = timedelta(**ttl_value)
+            else:
+                ttl = ttl_value or timedelta()
+
+            then_data = props.get("then")
+            then = VisibilityDeserializer.deserialize(then_data) if then_data else None
+
+            return AfterVisibility(ttl=ttl, then=then)
+
+        raise ValueError(f"Unknown visibility kind: {kind}")

flock/utils/visibility_utils.py

@@ -0,0 +1,134 @@
+"""Visibility deserialization utilities.
+
+This module handles complex visibility object deserialization from JSON data.
+Extracted from store.py to reduce complexity and improve testability.
+"""
+
+from __future__ import annotations
+
+import re
+from datetime import timedelta
+from typing import Any
+
+from flock.core.visibility import (
+    AfterVisibility,
+    LabelledVisibility,
+    PrivateVisibility,
+    PublicVisibility,
+    TenantVisibility,
+    Visibility,
+)
+
+
+ISO_DURATION_RE = re.compile(
+    r"^P(?:T?(?:(?P<hours>\d+)H)?(?:(?P<minutes>\d+)M)?(?:(?P<seconds>\d+)S)?)$"
+)
+
+
+def parse_iso_duration(value: str | None) -> timedelta:
+    """
+    Parse ISO 8601 duration string to timedelta.
+
+    Args:
+        value: ISO 8601 duration string (e.g., "PT1H30M")
+
+    Returns:
+        Parsed timedelta, or zero timedelta if invalid
+
+    Examples:
+        >>> parse_iso_duration("PT1H")
+        timedelta(hours=1)
+        >>> parse_iso_duration("PT30M")
+        timedelta(minutes=30)
+        >>> parse_iso_duration(None)
+        timedelta(0)
+    """
+    if not value:
+        return timedelta(0)
+    match = ISO_DURATION_RE.match(value)
+    if not match:
+        return timedelta(0)
+    hours = int(match.group("hours") or 0)
+    minutes = int(match.group("minutes") or 0)
+    seconds = int(match.group("seconds") or 0)
+    return timedelta(hours=hours, minutes=minutes, seconds=seconds)
+
+
+def deserialize_visibility(data: Any) -> Visibility:
+    """
+    Deserialize visibility object from JSON data.
+
+    Handles all visibility types: Public, Private, Labelled, Tenant, After.
+    Uses dictionary dispatch to reduce complexity vs if-elif chain.
+
+    Args:
+        data: JSON data dict or Visibility instance
+
+    Returns:
+        Visibility object (defaults to PublicVisibility if invalid)
+
+    Examples:
+        >>> deserialize_visibility({"kind": "Public"})
+        PublicVisibility()
+        >>> deserialize_visibility({"kind": "Private", "agents": ["agent1"]})
+        PrivateVisibility(agents={"agent1"})
+    """
+    # Early returns for simple cases
+    if isinstance(data, Visibility):
+        return data
+    if not data:
+        return PublicVisibility()
+
+    # Extract kind
+    kind = data.get("kind") if isinstance(data, dict) else None
+    if not kind:
+        return PublicVisibility()
+
+    # Dispatch to appropriate deserializer
+    return _VISIBILITY_DESERIALIZERS.get(kind, _deserialize_public)(data)
+
+
+def _deserialize_public(data: dict[str, Any]) -> PublicVisibility:
+    """Deserialize PublicVisibility."""
+    return PublicVisibility()
+
+
+def _deserialize_private(data: dict[str, Any]) -> PrivateVisibility:
+    """Deserialize PrivateVisibility."""
+    return PrivateVisibility(agents=set(data.get("agents", [])))
+
+
+def _deserialize_labelled(data: dict[str, Any]) -> LabelledVisibility:
+    """Deserialize LabelledVisibility."""
+    return LabelledVisibility(required_labels=set(data.get("required_labels", [])))
+
+
+def _deserialize_tenant(data: dict[str, Any]) -> TenantVisibility:
+    """Deserialize TenantVisibility."""
+    return TenantVisibility(tenant_id=data.get("tenant_id"))
+
+
+def _deserialize_after(data: dict[str, Any]) -> AfterVisibility:
+    """
+    Deserialize AfterVisibility with recursive 'then' handling.
+
+    Args:
+        data: JSON data dict with 'ttl' and optional 'then' fields
+
+    Returns:
+        AfterVisibility instance
+    """
+    ttl = parse_iso_duration(data.get("ttl"))
+    then_data = data.get("then") if isinstance(data, dict) else None
+    then_visibility = deserialize_visibility(then_data) if then_data else None
+    return AfterVisibility(ttl=ttl, then=then_visibility)
+
+
+# Dispatch table for visibility types
+_VISIBILITY_DESERIALIZERS = {
+    "Public": _deserialize_public,
+    "Private": _deserialize_private,
+    "Labelled": _deserialize_labelled,
+    "Tenant": _deserialize_tenant,
+    "After": _deserialize_after,
+}

{flock_core-0.5.11.dist-info → flock_core-0.5.21.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flock-core
-Version: 0.5.11
+Version: 0.5.21
 Summary: Flock: A declrative framework for building and orchestrating AI agents.
 Author-email: Andre Ratzenberger <andre.ratzenberger@whiteduck.de>
 License: MIT
@@ -62,6 +62,10 @@ Flock is a production-focused framework for orchestrating AI agents through **de
 - **[User Guides](https://whiteducksoftware.github.io/flock/guides/)** - In-depth feature documentation
 - **[API Reference](https://whiteducksoftware.github.io/flock/reference/api/)** - Complete API documentation
 - **[Roadmap](https://whiteducksoftware.github.io/flock/about/roadmap/)** - What's coming in v1.0
+- **Architecture & Patterns:**
+  - [Architecture Overview](docs/architecture.md) - System design and module organization
+  - [Error Handling Patterns](docs/patterns/error_handling.md) - Production error handling guide
+  - [Async Patterns](docs/patterns/async_patterns.md) - Async/await best practices
 
 ---
 
@@ -688,7 +692,7 @@ class LoggingComponent(AgentComponent):
     async def on_pre_evaluate(self, agent, ctx, inputs):
         logger.info(f"Agent {agent.name} evaluating: {inputs}")
         return inputs  # Pass through unchanged
-    
+
     async def on_post_evaluate(self, agent, ctx, inputs, result):
         logger.info(f"Agent {agent.name} produced: {result}")
         return result
@@ -730,7 +734,7 @@ flock = Flock("openai/gpt-4.1")
 flock.add_component(MaintenanceWindowComponent())
 ```
 
-**Built-in components**: 
+**Built-in components**:
 - `CircuitBreakerComponent` - Prevent runaway agent execution
 - `DeduplicationComponent` - Skip duplicate artifact/agent processing
 
@@ -1067,7 +1071,7 @@ We're building enterprise infrastructure for AI agents and tracking the work pub
 ```python
 import os
 from flock import Flock, flock_type
-from flock.visibility import PrivateVisibility, TenantVisibility, LabelledVisibility
+from flock.core.visibility import PrivateVisibility, TenantVisibility, LabelledVisibility
 from flock.identity import AgentIdentity
 from pydantic import BaseModel
 
@@ -1235,12 +1239,22 @@ uv run python examples/02-dashboard/01_declarative_pizza.py
 - 📖 [Documentation](https://whiteducksoftware.github.io/flock) - Complete online documentation
 - 📘 [AGENTS.md](AGENTS.md) - Development guide
 
+**Architecture & Patterns:**
+- 📐 [Architecture Overview](docs/architecture.md) - Understand the refactored codebase structure
+- 🔧 [Error Handling](docs/patterns/error_handling.md) - Production-ready error patterns
+- ⚡ [Async Patterns](docs/patterns/async_patterns.md) - Async/await best practices
+
 ---
 
 ## Contributing
 
 We're building Flock in the open. See **[Contributing Guide](https://whiteducksoftware.github.io/flock/about/contributing/)** for development setup, or check [CONTRIBUTING.md](CONTRIBUTING.md) and [AGENTS.md](AGENTS.md) locally.
 
+**Before contributing, familiarize yourself with:**
+- [Architecture Overview](docs/architecture.md) - Codebase organization (Phase 1-7 refactoring)
+- [Error Handling](docs/patterns/error_handling.md) - Required error patterns
+- [Async Patterns](docs/patterns/async_patterns.md) - Async/await standards
+
 **We welcome:**
 - Bug reports and feature requests
 - Documentation improvements
@@ -1308,6 +1322,6 @@ We're calling this 0.5 to signal:
 
 ---
 
-**Last Updated:** October 13, 2025
+**Last Updated:** October 19, 2025
 **Version:** Flock 0.5.0 (Blackboard Edition)
 **Status:** Production-Ready Core, Enterprise Features Roadmapped

{flock_core-0.5.11.dist-info → flock_core-0.5.21.dist-info}/RECORD

@@ -1,41 +1,63 @@
-flock/__init__.py,sha256=fvp4ltfaAGmYliShuTY_XVIpOUN6bMXbWiBnwb1NBoM,310
-flock/agent.py,sha256=luggPsY2pAnjt4TQ-S-ez1us5R2qk6UC-12ccjP6cMk,62607
-flock/api_models.py,sha256=Ot8riWjpf4p94P5IsdGz1vfQOizwLFrqwyzqkZWJDjc,9536
-flock/artifact_collector.py,sha256=j9p0qvu9IrmMTvOwdX3PGhEnj1-A3uMx0bMfG9zBdgo,6410
-flock/artifacts.py,sha256=QIUlol5hzUZO_8SINCqsN_Xr8fHixsc01QbFV_WIIj0,2527
-flock/batch_accumulator.py,sha256=4ZZLERkpH0XzN87-z2b5Tyjubheo_yCxoXz4lsjxUuk,8017
-flock/cli.py,sha256=lSx9qvK0AzfnGPjbMh2Jdsr8TlDA44huxUg_8tdlH_c,4564
-flock/components.py,sha256=SpqFmYBLNIGkKkVrfGpi-9eFj7jKA0N8VJHL-HiyzRc,8092
-flock/context_provider.py,sha256=Le01ZilMobaaPqZVJiBGFWkv1XnN3K6CtnPVD5Ewphk,20245
-flock/correlation_engine.py,sha256=pFD1y13bSMZ9HpUpp6RHWr5vb39gd0mf-rRQIFI0R5Q,8055
-flock/examples.py,sha256=z83GXjtroxRKplt57ur3v8UJFwf9cCHtZ3gj7QHiigs,3688
-flock/orchestrator.py,sha256=UgHL6knHZy6PHRmL_GOL91xDr2wfgFv0yB7SKS8AIj4,78263
-flock/orchestrator_component.py,sha256=lBn8WXiLzw3MXcU5JrNC3uH2SruLBCj8bSnSzH9txes,25210
+flock/__init__.py,sha256=RF9yUAbCXr2H2SYqWt46GT33B-nsyVdhDBodUkYF-RU,302
+flock/cli.py,sha256=axEX-UPk5l6lTOwaTpUUsIvjAGSdBcGRgONWZyInIAw,4573
+flock/examples.py,sha256=erw3awf5TyyYZZLl62nf8i77qwmzIZjK-qBaI0ioyFs,3707
 flock/registry.py,sha256=eCSK1yOgcY53vzaNFG4qnlLP3H9R4NWi9fTq_WUNjus,4846
-flock/runtime.py,sha256=DCClW_53ped_M0uMravPXmEGgVn_tOsyynNVYjZyM3c,10771
-flock/service.py,sha256=6-j2QPmtWiniZtEAfvAzdsLdEGPAfCPuwcusXFZfs1A,13341
-flock/store.py,sha256=hvecQqmx1xov7FyRCTwnyFJTpGb_7LHrHHQhGRWRUIE,46029
-flock/subscription.py,sha256=2_0jCxOlk-G1jsD6tiVILmKdmx-Wm1qGYzCZVbz_ktg,5424
-flock/system_artifacts.py,sha256=f4O-gErJRy5aMFVDh6ZGcj_5Gr130WnG28m5AfhnbxU,1083
-flock/utilities.py,sha256=PNIIBrtvwAkW6cI_OxF2dPS151ZjDNbFOaCfsul2BpE,12473
-flock/visibility.py,sha256=uwscg32t6Dp9LuA_EVDT5-_1lotzZWWS9Dl1foyJDxo,2926
+flock/agent/__init__.py,sha256=Fojf07SWgk6GsHaNouKpGQVHf5lH6q8LaWeDUEcI5lI,923
+flock/agent/builder_helpers.py,sha256=S3mPi3-cLZAB061kAKbOyHn2iptIOg74fVoSCrUOKG0,5952
+flock/agent/builder_validator.py,sha256=qQBoWStXKVQysqa1ysCYy2M89AbIfHPQ_ooACKDqbIM,5888
+flock/agent/component_lifecycle.py,sha256=ODZblOFqhEi3dSg-lVFeov-6ya8b4fPkWBi1QSaKMVI,11358
+flock/agent/context_resolver.py,sha256=0m8kCwBv9MDkeq7uvigT6cXI2FnRRk7tErWMz1fAP-0,4804
+flock/agent/mcp_integration.py,sha256=4krvKjtnZH0xegaacrPOnJxVuCXgpYcVe9-OlNvzryc,7817
+flock/agent/output_processor.py,sha256=9YT5q1sJbmqzxrzusiqzrfnIoxrVO3lN1OrHhO18dZA,12441
+flock/api/__init__.py,sha256=r5jHaA_onLMIQCRsSULxQ1eMLxDeTSI77t14_nNsebI,486
+flock/api/models.py,sha256=oZE063FJSRpHRyiNqG6pLld5EIst-wjdn3O-z9nzZSo,9484
+flock/api/service.py,sha256=Ut2qnm16ZRJu0iP0osEJH7VehIfcL6IGzGNq3HaCaew,13338
 flock/api/themes.py,sha256=7L-Bxhh8N1FXYsyTy7B_n8mSCGl_wDZXrvyY2llkF-A,1938
+flock/components/__init__.py,sha256=fMpjmfsW1eaD7nImyYFqHuJtO-dWSLQxoBQU9Ish6q8,965
+flock/components/agent/__init__.py,sha256=pT098n8PNOkkLjmKZ0Lvtbf7W0xEGm4w1aemAIW8reQ,479
+flock/components/agent/base.py,sha256=FDDTquqdlROFyOjQtXxJHEN95BVOWI79bDF4deFXE68,8144
+flock/components/agent/output_utility.py,sha256=BGlar7EaVjAenboCNOln3IpTTHDJQSnDNXGH0XbjILU,9314
+flock/components/orchestrator/__init__.py,sha256=pdUgs_JSPu058yZ5orCOHMaulS8-17HYhsjmBf1Omwc,697
+flock/components/orchestrator/base.py,sha256=ZL1d3xDdrRsG5cSJCN_GPB8sv2FaqNyo28nknzIcZvQ,14693
+flock/components/orchestrator/circuit_breaker.py,sha256=SH4pNFpe7MnkIRuK5TmRFBBOukp-Xc_BoyuhB5NNNSo,3249
+flock/components/orchestrator/collection.py,sha256=oTXDqNZgliwVqZO8e49mX3yEWxflzeZdD7UnbcHWypk,5572
+flock/components/orchestrator/deduplication.py,sha256=w4fwg3nLmb2TXPSSN3GEq5XPwviEEmmwu3fceSejBXw,2464
+flock/core/__init__.py,sha256=pEE4dbPtSEIC1WQYK8USWbF0EmZhccTfDO7eh7lzD-s,574
+flock/core/agent.py,sha256=mljIoTble2T7fQfT43-DRVPlkrplhOGaKPOLwl_Ge4I,36081
+flock/core/artifacts.py,sha256=dHDjn3DgS0Yo62oFoafQcdYNtqFrqLCzkvUytwm5VGU,2532
+flock/core/context_provider.py,sha256=1RG4lYhDNTshAQA1PwZELtUF2UDdC5NZWcBlE4BKDtc,20260
+flock/core/orchestrator.py,sha256=aoPh1k-vt_JWotXKcJ-I2j25NzLoS5inZPqiMNj4q-I,42276
+flock/core/store.py,sha256=4Zyh73RjjiUTtYTYiZ1pajWVXWKIew0dFERTNgQxRAA,31964
+flock/core/subscription.py,sha256=jIxoET1hvIcRGeLOKfPfLAH0IJvVAUc5_ZZYWPCIjr0,5429
+flock/core/visibility.py,sha256=uwscg32t6Dp9LuA_EVDT5-_1lotzZWWS9Dl1foyJDxo,2926
 flock/dashboard/__init__.py,sha256=_W6Id_Zb7mkSz0iHY1nfdUqF9p9uV_NyHsU7PFsRnFI,813
-flock/dashboard/collector.py,sha256=zMDv1OYWrDz5obNVMrc7uLImUH5yWIYCaMB0h-Uu2kY,21822
-flock/dashboard/events.py,sha256=ptKNaeHcgYnIO8rBTEK56ZC5w-dUWakXhNzDep1XaL4,7653
-flock/dashboard/graph_builder.py,sha256=jdiaruce5uRybndlA4aiOXW-gKkHeGtnndzYQ1WyU9Y,32006
+flock/dashboard/collector.py,sha256=TiMfp7i0lIJx4HTBKUwSj_vf5feNLyincge03mlWf2o,21843
+flock/dashboard/events.py,sha256=s81sAMQSlwRtwSfjrpauJTdJSYHwYtyvT50xrc7wdc4,7658
+flock/dashboard/graph_builder.py,sha256=EJiebAmbD2s66l7B8QxExN710zvO3lq_RwkvxoDwdlo,32036
 flock/dashboard/launcher.py,sha256=qnl1sFm9g2dAyzhyLPrfqAfld63G9aTNRHchgNuGnoo,8218
-flock/dashboard/service.py,sha256=-ksQ12D--EAi52WPR3PgBpRig0QZL8Fd9mq5PMEDBrI,54791
+flock/dashboard/service.py,sha256=bLusnlQ2LzPy_OZlq6DpEEAn6Ru3Rwg8IXO31YA5lB0,5770
 flock/dashboard/websocket.py,sha256=qv2cbX9DBhglYgGGPFsD9ryehkBsIcJQGg7tJTIDyMM,9689
 flock/dashboard/models/__init__.py,sha256=T4Yz8IXMm7lBqa2HLDSv7WJBtaKcdZIlTrz6GHNFZxs,68
 flock/dashboard/models/graph.py,sha256=mQBzaogaOV1sss4aI3yNK8Kg4SdztPwIu3VQfrB3zLU,5444
+flock/dashboard/routes/__init__.py,sha256=qNg67xqrINSb47EAgmX-S58UCLbg6IGsNZkU6MYM0SY,748
+flock/dashboard/routes/control.py,sha256=kKdbSVj0sKSIFpkEUUnvwpbRjH_4SkRLKuUBJH0b7BU,11546
+flock/dashboard/routes/helpers.py,sha256=bAYrLQE6VNNvTWANnSnEljknPcgmzRLxkxoRMV0zeMk,12238
+flock/dashboard/routes/themes.py,sha256=LJeTAvVY4q1rUGAZWdAy4MRPp0RAtIbsuUZZKFMpyxE,2294
+flock/dashboard/routes/traces.py,sha256=3JzerJmLESFaEQqdonshwafV7xhsmh_7XD-q_3lfwkc,18594
+flock/dashboard/routes/websocket.py,sha256=f7aU9WeWtc4HJzmyw_GGLDO3p71hJp4nbVpg4j7Yzek,3993
 flock/dashboard/static_v2/index.html,sha256=0KNfWwmpr0JmVNbalnsaQta0y3XlVhOQ_HSts2LuU3A,423
 flock/dashboard/static_v2/assets/index-DFRnI_mt.js,sha256=qeezaWLISr_EKNBBh8v0jzspd2KRcz8jW1r0p7z0Ht0,764860
 flock/dashboard/static_v2/assets/index-fPLNdmp1.css,sha256=skpvfkkrlw7WbmBh7HN-rUKAtKP-gpuLUH4klUgFHT4,74529
 flock/engines/__init__.py,sha256=waNyObJ8PKCLFZL3WUFynxSK-V47m559P3Px-vl_OSc,124
-flock/engines/dspy_engine.py,sha256=b3PkeyBzcKI1ijR3ojR4FOisdKrxE_hxZhF5WhxKDmQ,75000
+flock/engines/dspy_engine.py,sha256=tIdNCsQjyzWnTRzQBVLyfY4xP0FKoXHEfV4_4ch_xTQ,20058
+flock/engines/dspy/__init__.py,sha256=ONqJyNfaZaqBno4ggDq092lquZ8KjbloRO9zTZISjoA,734
+flock/engines/dspy/artifact_materializer.py,sha256=ZxcW2eUVt0PknM_qB4tbH4U5SiOrGWiku08joiqygVg,8001
+flock/engines/dspy/signature_builder.py,sha256=4o2zNDCouUxAJOHoONolflnWu5WGrsKSvHuc5Dzetjk,17790
+flock/engines/dspy/streaming_executor.py,sha256=6fERID0QQmhAMg1l2Zvtq65Ah9B0vBcFI5lTdS5UXsY,28437
 flock/engines/examples/__init__.py,sha256=cDAjF8_NPL7nhpwa_xxgnPYRAXZWppKE2HkxmL8LGAI,126
-flock/engines/examples/simple_batch_engine.py,sha256=0zQozoiNFq_UcBU5plAqg1VjtP6g6eib7VKATEjnRf8,2902
+flock/engines/examples/simple_batch_engine.py,sha256=p_4YkQ6PI1q09calMxDDRYOdB8naMxklKEzWPMQyrVE,2914
+flock/engines/streaming/__init__.py,sha256=gyn-GQ538RiRbaE1SpBSejw7x6JNcii91Uw2yF7335E,62
+flock/engines/streaming/sinks.py,sha256=eLboWkBuixiZHyHgU0pSQ9QTL6lcNY9EVmR9sFg4KpE,17079
 flock/frontend/README.md,sha256=0dEzu4UxacGfSstz9_R0KSeFWJ1vNRi0p-KLIay_TfU,26212
 flock/frontend/index.html,sha256=BFg1VR_YVAJ_MGN16xa7sT6wTGwtFYUhfJhGuKv89VM,312
 flock/frontend/package-lock.json,sha256=vNOaISeq3EfEDDEsFYPWFaMsqypDgQIE0P_u6tzE0g4,150798
@@ -159,10 +181,9 @@ flock/frontend/src/types/theme.ts,sha256=bjV2zWxBJilEXeosjSSirw05dL7zICShUDx2H0o
 flock/frontend/src/utils/artifacts.ts,sha256=JjbNXKgcBaUJdR7VKDi0LK0T3d-ltYt4HHbiQNB3rmI,790
 flock/frontend/src/utils/mockData.ts,sha256=XysjTPAcq6P7BXD8yHv-zJ5vNsxG1T5TLJjX4phOU_w,2316
 flock/frontend/src/utils/performance.ts,sha256=ZcZjR8DKwF2ixveng2tKIRiW8wZ-ee_RPZFfi1jm4Zo,507
-flock/helper/cli_helper.py,sha256=IfhD0CZzRnhsyLzjzWEZBAFqLIHIFeedYTwW48KfnmM,50476
 flock/logging/__init__.py,sha256=RyR9jTC0q02Fh0L8easQfki2uCOSTii5MPhrxcqQNsg,163
 flock/logging/auto_trace.py,sha256=iNx4LZsXjykOQOubBoGpOhldJQeRO94rarS9bFjZ_pM,5562
-flock/logging/logging.py,sha256=Jdei9EYMX_4mSQmJu5plETVaqQ8BBu211DAkmqKhRhk,20270
+flock/logging/logging.py,sha256=T1TCNWXnKAnN8E1v6O3Lbh8XBrZhzCJZjo-hs6_FYmI,19726
 flock/logging/telemetry.py,sha256=KWkqB-aMuD7gv2ABMwRjiiJ_DwDtPcOraLWJCB4jRXI,8324
 flock/logging/trace_and_logged.py,sha256=uVOFU0iyl0LzrCi3dWjDHTwastCFN2WTMAtaUJeFYn4,11504
 flock/logging/formatters/enum_builder.py,sha256=y8SjIHPs7ajT9QHR6wjjBmmL7ZrxFzegaBTb5ApOHvY,975
@@ -194,8 +215,36 @@ flock/mcp/types/handlers.py,sha256=MaUNpjfLFi7sozoj-nQDUOCLeoaFD8tdos6XkjBUCzI,7
 flock/mcp/types/types.py,sha256=EG2YuDlFCHzE4k4XIMur9QPn_6i7N621s90OXeAVRfc,11511
 flock/mcp/util/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 flock/mcp/util/helpers.py,sha256=jO8DqqSb_S4dyvsxv5vlMGRoMx92Su_5-Uv17gQNuLU,740
+flock/models/__init__.py,sha256=724PD_4bRX0rFdBDXzP0Pwr-OUntq0LIH48bMmtfcM0,266
+flock/models/system_artifacts.py,sha256=f4O-gErJRy5aMFVDh6ZGcj_5Gr130WnG28m5AfhnbxU,1083
+flock/orchestrator/__init__.py,sha256=u4DDXcwCSGrpHYbkdA4eP4W9Uj9vNMF6qxxUtygwmEU,1728
+flock/orchestrator/artifact_collector.py,sha256=XUB4dmx2tzq0p2CkYfP4NowfBkryp3DNA9jb7PWEIDk,6419
+flock/orchestrator/artifact_manager.py,sha256=fXqyU1pRDLf7MRxK86CMHr7uDOeeom_PEZ-3pVZxTj0,5775
+flock/orchestrator/batch_accumulator.py,sha256=WbIQqQz03LRLPe9yJsf_6TgppofE2tN_7f60P38n2S8,8027
+flock/orchestrator/component_runner.py,sha256=pf068DRGw4unh4K09Y8gt-OLM3FLm6CHQQ3d13jzkmM,14266
+flock/orchestrator/context_builder.py,sha256=Wp7_lzu_F7y-be6uiplur0VGauuP58NSmu1foXFfZc0,6244
+flock/orchestrator/correlation_engine.py,sha256=oVeV8EQpjc0Bt7YVzyUQXlEelOre8hQPUH3Dmh87lyE,8065
+flock/orchestrator/event_emitter.py,sha256=2wWrM_mZ2MwFLVo6FYfp9PrHrfOkzUp96C6U5HnCZAE,6632
+flock/orchestrator/initialization.py,sha256=jjbfGhdxPW6L4o59mwXCXskIPFR_UlTIKvcHMyIhNbE,6349
+flock/orchestrator/lifecycle_manager.py,sha256=mANaJhJ96p_bwDfSn6ieBShAUfantXDyWyDyR6pJ3ZM,9270
+flock/orchestrator/mcp_manager.py,sha256=24nfmf729PjTyQG06UyymRHTp9Zu-qbqFCW6FmeVDuo,7081
+flock/orchestrator/scheduler.py,sha256=SG8BSb00MfYdpbAmBumiP_45UEmSoZLbN2z_LyoM1ko,6368
+flock/orchestrator/server_manager.py,sha256=u_ZD50Yqw-zyxM3PMJexGAQxETpWZrV6aiAixDiC_Lk,8935
+flock/orchestrator/tracing.py,sha256=luL5I5ch98C5riGc5e9xrHl-iE-IwuIAVpDBdNQZ27Y,5099
 flock/patches/__init__.py,sha256=KfRTpO_rz547iKxJDknymar1P3lS_8AhDh-sR1BkcZ0,194
 flock/patches/dspy_streaming_patch.py,sha256=OQeLYWmL-7rqudphMwERnpvXhXamnvYn3xNcySajacY,2879
+flock/storage/__init__.py,sha256=9-p-RTpxGJOksfDavbpUsTghSIjDGtWCEC3bpVuYZY0,249
+flock/storage/artifact_aggregator.py,sha256=wMpoXjko9UmfMmQ_qUTzSX-nhb0k8BVRlzRLHlkKEug,5176
+flock/storage/in_memory/__init__.py,sha256=XPYxGNnpDjiv_L1tj8AxfORA_xHP16FV8t5UqrhtFLk,138
+flock/storage/in_memory/artifact_filter.py,sha256=22TQdXdhPHUmpQTBsiIiPE016XaSZlC9Gx_KxqK7Gog,3902
+flock/storage/in_memory/history_aggregator.py,sha256=0zJA6w0bOn0cblfYq19WMR5keUFJ2hXhLzB82MZThzE,3603
+flock/storage/sqlite/__init__.py,sha256=khUvf8X9k9qnJjV_UFltkeoGp7qs9M6vGWCsuyGxfZw,245
+flock/storage/sqlite/agent_history_queries.py,sha256=pXabVwqZrGUBgO_k8mqr7PKuJ2LzfOFHGddSCtuSM4U,5061
+flock/storage/sqlite/consumption_loader.py,sha256=31eyFXXl7igN4ijxIh-uvuGD9DUjrjAQYYczHhG-TXk,3047
+flock/storage/sqlite/query_builder.py,sha256=QjRS35CKT-90ORnwEA7X1SCO65wySVZC1kYpKPXzNns,4065
+flock/storage/sqlite/query_params_builder.py,sha256=Tjq0aGIEwhvNtlAKx3tWhASzEAo48Xiiro72c9CZaX8,2781
+flock/storage/sqlite/schema_manager.py,sha256=F-zDks90V3xwGAuvF3cj3I4xkkgYvJLCC_8QVZ_iPnE,4915
+flock/storage/sqlite/summary_queries.py,sha256=U7rsgWoPRVXcGbS7bN0SQ_r2vERgazjbCZ4nupVQtxM,5940
 flock/themes/3024-day.toml,sha256=uOVHqEzSyHx0WlUk3D0lne4RBsNBAPCTy3C58yU7kEY,667
 flock/themes/3024-night.toml,sha256=qsXUwd6ZYz6J-R129_Ao2TKlvvK60svhZJJjB5c8Tfo,1667
 flock/themes/aardvark-blue.toml,sha256=5ZgsxP3pWLPN3yJ2Wd9ErCo7fy_VJpIfje4kriDKlqo,1667
@@ -532,9 +581,18 @@ flock/themes/zenburn.toml,sha256=NxOAR3cx-Z9PVErEKHFZ6jsjfKBtPmfyN_vGSri5_qo,171
 flock/themes/zenburned.toml,sha256=UEmquBbcAO3Zj652XKUwCsNoC2iQSlIh-q5c6DH-7Kc,1664
 flock/themes/zenwritten-dark.toml,sha256=-dgaUfg1iCr5Dv4UEeHv_cN4GrPUCWAiHSxWK20X1kI,1663
 flock/themes/zenwritten-light.toml,sha256=G1iEheCPfBNsMTGaVpEVpDzYBHA_T-MV27rolUYolmE,1666
-flock/utility/output_utility_component.py,sha256=YXzVy4EZXTrz0o6DjlE6tna4N79T5S5b98qDS42KqXM,9316
-flock_core-0.5.11.dist-info/METADATA,sha256=r87xPBNRpCHFwDSyKCVDLflsouPrAO5fXPh9BN3HlB0,51253
-flock_core-0.5.11.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-flock_core-0.5.11.dist-info/entry_points.txt,sha256=UQdPmtHd97gSA_IdLt9MOd-1rrf_WO-qsQeIiHWVrp4,42
-flock_core-0.5.11.dist-info/licenses/LICENSE,sha256=U3IZuTbC0yLj7huwJdldLBipSOHF4cPf6cUOodFiaBE,1072
-flock_core-0.5.11.dist-info/RECORD,,
+flock/utils/__init__.py,sha256=0EPfSUqxPEcgMVl02acwO4rdUsePZSTahxXd1DA4ygo,442
+flock/utils/async_utils.py,sha256=CzVXWXPCK-IP-defXCZ5fsDZaLhRiz2l67_FtMN-TAo,1963
+flock/utils/cli_helper.py,sha256=IfhD0CZzRnhsyLzjzWEZBAFqLIHIFeedYTwW48KfnmM,50476
+flock/utils/runtime.py,sha256=XEIXIXP2jcJsE7I-taI2PVxrUo-EHsxIupYeBt5YFHg,10786
+flock/utils/time_utils.py,sha256=LWRLnJ8kVHmsKcC0FWi4RqWynnKr9B2zXhc6BH7e8OM,1405
+flock/utils/type_resolution.py,sha256=oVIX6r4QencA4faV7JfASMvKrAprjLcpKJnhlsBeZhE,1114
+flock/utils/utilities.py,sha256=E3EQDo5SLU4XeoL3-PCc4lOatJHFEkMHKbZhnGhdMG4,12485
+flock/utils/validation.py,sha256=Vqzd8Qi73ttJNSHdr8EUEonyfzAYWVfEyW0fhLs1bA4,1847
+flock/utils/visibility.py,sha256=riJfHFWH8R2vk3DU7PYNi2LMaE8cy8pnMvxxiqWq-4I,2349
+flock/utils/visibility_utils.py,sha256=eGA28aL8FnGyGzsbVNvqI1UoPauu1Jedl5LUZ5oWZZ0,3874
+flock_core-0.5.21.dist-info/METADATA,sha256=hmjtqBjzTW2b_xq59iqZYSpkhRXVHTZDYBng_8AQuJg,52163
+flock_core-0.5.21.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+flock_core-0.5.21.dist-info/entry_points.txt,sha256=UQdPmtHd97gSA_IdLt9MOd-1rrf_WO-qsQeIiHWVrp4,42
+flock_core-0.5.21.dist-info/licenses/LICENSE,sha256=U3IZuTbC0yLj7huwJdldLBipSOHF4cPf6cUOodFiaBE,1072
+flock_core-0.5.21.dist-info/RECORD,,