flock-core 0.5.3__py3-none-any.whl → 0.5.5__py3-none-any.whl

flock/orchestrator.py

@@ -8,7 +8,7 @@ import os
 from asyncio import Task
 from collections.abc import AsyncGenerator, Iterable, Mapping, Sequence
 from contextlib import asynccontextmanager
-from datetime import datetime, timezone
+from datetime import datetime, timedelta, timezone
 from pathlib import Path
 from typing import TYPE_CHECKING, Any
 from uuid import uuid4
@@ -135,8 +135,16 @@ class Flock(metaclass=AutoTracedMeta):
         self._artifact_collector = ArtifactCollector()
         # JoinSpec logic: Correlation engine for correlated AND gates
         self._correlation_engine = CorrelationEngine()
+        # Background task for checking correlation expiry (time-based JoinSpec)
+        self._correlation_cleanup_task: Task[Any] | None = None
+        self._correlation_cleanup_interval: float = 0.1  # Check every 100ms
         # BatchSpec logic: Batch accumulator for size/timeout batching
         self._batch_engine = BatchEngine()
+        # Background task for checking batch timeouts
+        self._batch_timeout_task: Task[Any] | None = None
+        self._batch_timeout_interval: float = 0.1  # Check every 100ms
+        # Phase 1.2: WebSocket manager for real-time dashboard events (set by serve())
+        self._websocket_manager: Any = None
         # Unified tracing support
         self._workflow_span = None
         self._auto_workflow_enabled = os.getenv("FLOCK_AUTO_WORKFLOW_TRACE", "false").lower() in {
@@ -471,6 +479,33 @@ class Flock(metaclass=AutoTracedMeta):
             await asyncio.sleep(0.01)
             pending = {task for task in self._tasks if not task.done()}
             self._tasks = pending
+
+        # Determine whether any deferred work (timeouts/cleanup) is still pending.
+        pending_batches = any(
+            accumulator.artifacts for accumulator in self._batch_engine.batches.values()
+        )
+        pending_correlations = any(
+            groups and any(group.waiting_artifacts for group in groups.values())
+            for groups in self._correlation_engine.correlation_groups.values()
+        )
+
+        # Ensure watchdog loops remain active while pending work exists.
+        if pending_batches and (
+            self._batch_timeout_task is None or self._batch_timeout_task.done()
+        ):
+            self._batch_timeout_task = asyncio.create_task(self._batch_timeout_checker_loop())
+
+        if pending_correlations and (
+            self._correlation_cleanup_task is None or self._correlation_cleanup_task.done()
+        ):
+            self._correlation_cleanup_task = asyncio.create_task(self._correlation_cleanup_loop())
+
+        # If deferred work is still outstanding, consider the orchestrator quiescent for
+        # now but leave watchdog tasks running to finish the job.
+        if pending_batches or pending_correlations:
+            self._agent_iteration_count.clear()
+            return
+
         # T068: Reset circuit breaker counters when idle
         self._agent_iteration_count.clear()
 
@@ -546,6 +581,22 @@ class Flock(metaclass=AutoTracedMeta):
 
     async def shutdown(self) -> None:
         """Shutdown orchestrator and clean up resources."""
+        # Cancel correlation cleanup task if running
+        if self._correlation_cleanup_task and not self._correlation_cleanup_task.done():
+            self._correlation_cleanup_task.cancel()
+            try:
+                await self._correlation_cleanup_task
+            except asyncio.CancelledError:
+                pass
+
+        # Cancel batch timeout checker if running
+        if self._batch_timeout_task and not self._batch_timeout_task.done():
+            self._batch_timeout_task.cancel()
+            try:
+                await self._batch_timeout_task
+            except asyncio.CancelledError:
+                pass
+
         if self._mcp_manager is not None:
             await self._mcp_manager.cleanup_all()
             self._mcp_manager = None
@@ -602,6 +653,8 @@ class Flock(metaclass=AutoTracedMeta):
 
         # Store collector reference for agents added later
         self._dashboard_collector = event_collector
+        # Store websocket manager for real-time event emission (Phase 1.2)
+        self._websocket_manager = websocket_manager
 
         # Inject event collector into all existing agents
         for agent in self._agents.values():
@@ -905,8 +958,23 @@ class Flock(metaclass=AutoTracedMeta):
                         subscription_index=subscription_index,
                     )
 
+                    # Start correlation cleanup task if time-based window and not running
+                    if (
+                        isinstance(subscription.join.within, timedelta)
+                        and self._correlation_cleanup_task is None
+                    ):
+                        self._correlation_cleanup_task = asyncio.create_task(
+                            self._correlation_cleanup_loop()
+                        )
+
                     if completed_group is None:
                         # Still waiting for correlation to complete
+                        # Phase 1.2: Emit real-time correlation update event
+                        await self._emit_correlation_updated_event(
+                            agent_name=agent.name,
+                            subscription_index=subscription_index,
+                            artifact=artifact,
+                        )
                         continue
 
                     # Correlation complete! Get all correlated artifacts
@@ -938,6 +1006,12 @@ class Flock(metaclass=AutoTracedMeta):
                             subscription=subscription,
                             subscription_index=subscription_index,
                         )
+
+                        # Start timeout checker if this batch has a timeout and checker not running
+                        if subscription.batch.timeout and self._batch_timeout_task is None:
+                            self._batch_timeout_task = asyncio.create_task(
+                                self._batch_timeout_checker_loop()
+                            )
                     else:
                         # Single type subscription: Add each artifact individually
                         should_flush = False
@@ -948,12 +1022,25 @@ class Flock(metaclass=AutoTracedMeta):
                                 subscription_index=subscription_index,
                             )
 
+                            # Start timeout checker if this batch has a timeout and checker not running
+                            if subscription.batch.timeout and self._batch_timeout_task is None:
+                                self._batch_timeout_task = asyncio.create_task(
+                                    self._batch_timeout_checker_loop()
+                                )
+
                             if should_flush:
                                 # Size threshold reached! Flush batch now
                                 break
 
                     if not should_flush:
                         # Batch not full yet - wait for more artifacts
+                        # Phase 1.2: Emit real-time batch update event
+                        await self._emit_batch_item_added_event(
+                            agent_name=agent.name,
+                            subscription_index=subscription_index,
+                            subscription=subscription,
+                            artifact=artifact,
+                        )
                         continue
 
                     # Flush the batch and get all accumulated artifacts
@@ -977,10 +1064,14 @@ class Flock(metaclass=AutoTracedMeta):
                     self._mark_processed(collected_artifact, agent)
 
                 # Schedule agent with ALL artifacts (batched, correlated, or AND gate complete)
-                self._schedule_task(agent, artifacts)
+                # NEW: Mark as batch execution if flushed from BatchSpec
+                is_batch_execution = subscription.batch is not None
+                self._schedule_task(agent, artifacts, is_batch=is_batch_execution)
 
-    def _schedule_task(self, agent: Agent, artifacts: list[Artifact]) -> None:
-        task = asyncio.create_task(self._run_agent_task(agent, artifacts))
+    def _schedule_task(
+        self, agent: Agent, artifacts: list[Artifact], is_batch: bool = False
+    ) -> None:
+        task = asyncio.create_task(self._run_agent_task(agent, artifacts, is_batch=is_batch))
         self._tasks.add(task)
         task.add_done_callback(self._tasks.discard)
 
@@ -995,14 +1086,17 @@ class Flock(metaclass=AutoTracedMeta):
         key = (str(artifact.id), agent.name)
         return key in self._processed
 
-    async def _run_agent_task(self, agent: Agent, artifacts: list[Artifact]) -> None:
+    async def _run_agent_task(
+        self, agent: Agent, artifacts: list[Artifact], is_batch: bool = False
+    ) -> None:
         correlation_id = artifacts[0].correlation_id if artifacts else uuid4()
 
         ctx = Context(
             board=BoardHandle(self),
             orchestrator=self,
             task_id=str(uuid4()),
-            correlation_id=correlation_id,  # NEW!
+            correlation_id=correlation_id,
+            is_batch=is_batch,  # NEW!
         )
         self._record_agent_run(agent)
         await agent.execute(ctx, artifacts)
@@ -1026,13 +1120,174 @@ class Flock(metaclass=AutoTracedMeta):
             except Exception as exc:  # pragma: no cover - defensive logging
                 self._logger.exception("Failed to record artifact consumption: %s", exc)
 
+    # Phase 1.2: Logic Operations Event Emission ----------------------------
+
+    async def _emit_correlation_updated_event(
+        self, *, agent_name: str, subscription_index: int, artifact: Artifact
+    ) -> None:
+        """Emit CorrelationGroupUpdatedEvent for real-time dashboard updates.
+
+        Called when an artifact is added to a correlation group that is not yet complete.
+
+        Args:
+            agent_name: Name of the agent with the JoinSpec subscription
+            subscription_index: Index of the subscription in the agent's subscriptions list
+            artifact: The artifact that triggered this update
+        """
+        # Only emit if dashboard is enabled
+        if self._websocket_manager is None:
+            return
+
+        # Import _get_correlation_groups helper from dashboard service
+        from flock.dashboard.service import _get_correlation_groups
+
+        # Get current correlation groups state from engine
+        groups = _get_correlation_groups(self._correlation_engine, agent_name, subscription_index)
+
+        if not groups:
+            return  # No groups to report (shouldn't happen, but defensive)
+
+        # Find the group that was just updated (match by last updated time or artifact ID)
+        # For now, we'll emit an event for the FIRST group that's still waiting
+        # In practice, the artifact we just added should be in one of these groups
+        for group_state in groups:
+            if not group_state["is_complete"]:
+                # Import CorrelationGroupUpdatedEvent
+                from flock.dashboard.events import CorrelationGroupUpdatedEvent
+
+                # Build and emit event
+                event = CorrelationGroupUpdatedEvent(
+                    agent_name=agent_name,
+                    subscription_index=subscription_index,
+                    correlation_key=group_state["correlation_key"],
+                    collected_types=group_state["collected_types"],
+                    required_types=group_state["required_types"],
+                    waiting_for=group_state["waiting_for"],
+                    elapsed_seconds=group_state["elapsed_seconds"],
+                    expires_in_seconds=group_state["expires_in_seconds"],
+                    expires_in_artifacts=group_state["expires_in_artifacts"],
+                    artifact_id=str(artifact.id),
+                    artifact_type=artifact.type,
+                    is_complete=group_state["is_complete"],
+                )
+
+                # Broadcast via WebSocket
+                await self._websocket_manager.broadcast(event)
+                break  # Only emit one event per artifact addition
+
+    async def _emit_batch_item_added_event(
+        self,
+        *,
+        agent_name: str,
+        subscription_index: int,
+        subscription: Subscription,  # noqa: F821
+        artifact: Artifact,
+    ) -> None:
+        """Emit BatchItemAddedEvent for real-time dashboard updates.
+
+        Called when an artifact is added to a batch that hasn't reached flush threshold.
+
+        Args:
+            agent_name: Name of the agent with the BatchSpec subscription
+            subscription_index: Index of the subscription in the agent's subscriptions list
+            subscription: The subscription with BatchSpec configuration
+            artifact: The artifact that triggered this update
+        """
+        # Only emit if dashboard is enabled
+        if self._websocket_manager is None:
+            return
+
+        # Import _get_batch_state helper from dashboard service
+        from flock.dashboard.service import _get_batch_state
+
+        # Get current batch state from engine
+        batch_state = _get_batch_state(
+            self._batch_engine, agent_name, subscription_index, subscription.batch
+        )
+
+        if not batch_state:
+            return  # No batch to report (shouldn't happen, but defensive)
+
+        # Import BatchItemAddedEvent
+        from flock.dashboard.events import BatchItemAddedEvent
+
+        # Build and emit event
+        event = BatchItemAddedEvent(
+            agent_name=agent_name,
+            subscription_index=subscription_index,
+            items_collected=batch_state["items_collected"],
+            items_target=batch_state.get("items_target"),
+            items_remaining=batch_state.get("items_remaining"),
+            elapsed_seconds=batch_state["elapsed_seconds"],
+            timeout_seconds=batch_state.get("timeout_seconds"),
+            timeout_remaining_seconds=batch_state.get("timeout_remaining_seconds"),
+            will_flush=batch_state["will_flush"],
+            artifact_id=str(artifact.id),
+            artifact_type=artifact.type,
+        )
+
+        # Broadcast via WebSocket
+        await self._websocket_manager.broadcast(event)
+
     # Batch Helpers --------------------------------------------------------
 
+    async def _correlation_cleanup_loop(self) -> None:
+        """Background task that periodically cleans up expired correlation groups.
+
+        Runs continuously until all correlation groups are cleared or orchestrator shuts down.
+        Checks every 100ms for time-based expired correlations and discards them.
+        """
+        try:
+            while True:
+                await asyncio.sleep(self._correlation_cleanup_interval)
+                self._cleanup_expired_correlations()
+
+                # Stop if no correlation groups remain
+                if not self._correlation_engine.correlation_groups:
+                    self._correlation_cleanup_task = None
+                    break
+        except asyncio.CancelledError:
+            # Clean shutdown
+            self._correlation_cleanup_task = None
+            raise
+
+    def _cleanup_expired_correlations(self) -> None:
+        """Clean up all expired correlation groups across all subscriptions.
+
+        Called periodically by background task to enforce time-based correlation windows.
+        Discards incomplete correlations that have exceeded their time window.
+        """
+        # Get all active subscription keys
+        for agent_name, subscription_index in list(
+            self._correlation_engine.correlation_groups.keys()
+        ):
+            self._correlation_engine.cleanup_expired(agent_name, subscription_index)
+
+    async def _batch_timeout_checker_loop(self) -> None:
+        """Background task that periodically checks for batch timeouts.
+
+        Runs continuously until all batches are cleared or orchestrator shuts down.
+        Checks every 100ms for expired batches and flushes them.
+        """
+        try:
+            while True:
+                await asyncio.sleep(self._batch_timeout_interval)
+                await self._check_batch_timeouts()
+
+                # Stop if no batches remain
+                if not self._batch_engine.batches:
+                    self._batch_timeout_task = None
+                    break
+        except asyncio.CancelledError:
+            # Clean shutdown
+            self._batch_timeout_task = None
+            raise
+
     async def _check_batch_timeouts(self) -> None:
         """Check all batches for timeout expiry and flush expired batches.
 
-        This method is called periodically or manually (in tests) to enforce
-        timeout-based batching.
+        This method is called periodically by the background timeout checker
+        or manually (in tests) to enforce timeout-based batching.
         """
         expired_batches = self._batch_engine.check_timeouts()
 
@@ -1048,21 +1303,21 @@ class Flock(metaclass=AutoTracedMeta):
             if agent is None:
                 continue
 
-            # Schedule agent with batched artifacts
-            self._schedule_task(agent, artifacts)
+            # Schedule agent with batched artifacts (timeout flush)
+            self._schedule_task(agent, artifacts, is_batch=True)
 
     async def _flush_all_batches(self) -> None:
         """Flush all partial batches (for shutdown - ensures zero data loss)."""
         all_batches = self._batch_engine.flush_all()
 
-        for agent_name, subscription_index, artifacts in all_batches:
+        for agent_name, _subscription_index, artifacts in all_batches:
             # Get the agent
             agent = self._agents.get(agent_name)
             if agent is None:
                 continue
 
-            # Schedule agent with partial batch
-            self._schedule_task(agent, artifacts)
+            # Schedule agent with partial batch (shutdown flush)
+            self._schedule_task(agent, artifacts, is_batch=True)
 
         # Wait for all scheduled tasks to complete
         await self.run_until_idle()

flock/patches/__init__.py

@@ -2,4 +2,5 @@
 
 from flock.patches.dspy_streaming_patch import apply_patch, restore_original
 
+
 __all__ = ["apply_patch", "restore_original"]

flock/patches/dspy_streaming_patch.py

@@ -10,6 +10,7 @@ This patch replaces it with a non-blocking fire-and-forget approach.
 import asyncio
 import logging
 
+
 logger = logging.getLogger(__name__)
 
 

flock/runtime.py

@@ -250,6 +250,9 @@ class Context(BaseModel):
     correlation_id: UUID | None = None  # NEW!
     task_id: str
     state: dict[str, Any] = Field(default_factory=dict)
+    is_batch: bool = Field(
+        default=False, description="True if this execution is processing a BatchSpec accumulation"
+    )
 
     def get_variable(self, key: str, default: Any = None) -> Any:
         return self.state.get(key, default)

{flock_core-0.5.3.dist-info → flock_core-0.5.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flock-core
-Version: 0.5.3
+Version: 0.5.5
 Summary: Flock: A declrative framework for building and orchestrating AI agents.
 Author-email: Andre Ratzenberger <andre.ratzenberger@whiteduck.de>
 License: MIT
@@ -57,6 +57,8 @@ Flock is a production-focused framework for orchestrating AI agents through **de
 **Quick links:**
 - **[Getting Started](https://whiteducksoftware.github.io/flock/getting-started/installation/)** - Installation and first steps
 - **[Tutorials](https://whiteducksoftware.github.io/flock/tutorials/)** - Step-by-step learning path
+  - [Custom Engines: Emoji Vibes & Batch Brews](https://whiteducksoftware.github.io/flock/tutorials/custom-engines/)
+  - [Custom Agent Components: Foreshadow & Hype](https://whiteducksoftware.github.io/flock/tutorials/custom-agent-components/)
 - **[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
@@ -373,6 +375,10 @@ validator = flock.agent("validator").consumes(Image, Image, Metadata).publishes(
 
 **Advanced subscriptions unlock crazy powerful patterns:**
 
+<p align="center">
+  <img alt="Event Join" src="docs/assets/images/join.png" width="800">
+</p>
+
 ```python
 # 🎯 Predicates - Smart filtering (only process critical cases)
 urgent_care = flock.agent("urgent").consumes(
@@ -414,6 +420,10 @@ quality_control = flock.agent("qc").consumes(
 - 🏭 Manufacturing: Monitor 1000+ IoT sensors with efficient batching
 - 📊 Finance: Match trades + confirmations within 5-minute windows
 
+<p align="center">
+  <img alt="Event Batch" src="docs/assets/images/batch.png" width="800">
+</p>
+
 ### Visibility Controls (The Security)
 
 **Unlike other frameworks, Flock has zero-trust security built-in:**

{flock_core-0.5.3.dist-info → flock_core-0.5.5.dist-info}/RECORD

@@ -1,15 +1,15 @@
 flock/__init__.py,sha256=fvp4ltfaAGmYliShuTY_XVIpOUN6bMXbWiBnwb1NBoM,310
-flock/agent.py,sha256=vk15p1bw2YeTPAWLZHe2I6c558cAkZXi5DERbIL15kg,41808
-flock/artifact_collector.py,sha256=5aLgR_YSyMprWEiVA39JqpMue--N2vbpMICTWQX9b5A,6394
+flock/agent.py,sha256=zlhrY8jWE6LK8hmOHaQWbfnX7_T_6Eg6Qb7oviujJiY,42715
+flock/artifact_collector.py,sha256=8rsg5NzmXeXKNT07TqX1_Z6aAGud2dXKzvS0jhjX3gQ,6372
 flock/artifacts.py,sha256=3vQQ1J7QxTzeQBUGaNLiyojlmBv1NfdhFC98-qj8fpU,2541
-flock/batch_accumulator.py,sha256=b1DEQ1YUhwI9aG0frgFWCLlytsmYbpqG_-BoNe9emhk,8049
+flock/batch_accumulator.py,sha256=YcZSpdYMhm8wAGqKEF49NJ_Jl2HZX78NrJYqfyHqTuE,8003
 flock/cli.py,sha256=lPtKxEXnGtyuTh0gyG3ixEIFS4Ty6Y0xsPd6SpUTD3U,4526
-flock/components.py,sha256=17vhNMHKc3VUruEbSdb9YNKcDziIe0coS9jpfWBmX4o,6259
-flock/correlation_engine.py,sha256=cDSCPDTIo-TuRYESMIqfKjs53avs7gPVdzZ_AfpH8a0,7999
+flock/components.py,sha256=7y2UWaIU0wBl44xO0SkU1m04ixbj4gd_FP9wFpsuZhY,7609
+flock/correlation_engine.py,sha256=iGB6-G5F-B-pw-clLx4-pZEiUrK_Q2l3kOn4jtEO_kw,8103
 flock/examples.py,sha256=eQb8k6EYBbUhauFuSN_0EIIu5KW0mTqJU0HM4-p14sc,3632
-flock/orchestrator.py,sha256=O_4PdPZDyysZcOhzxKaFF1W0bp3SHtZonynTgHwSoxw,42786
+flock/orchestrator.py,sha256=YJ8M7HxCUjq4hZ9wj3XKbOfLPVq-_zeTPclhI0YBaA0,54530
 flock/registry.py,sha256=s0-H-TMtOsDZiZQCc7T1tYiWQg3OZHn5T--jaI_INIc,4786
-flock/runtime.py,sha256=UG-38u578h628mSddBmyZn2VIzFQ0wlHCpCALFiScqA,8518
+flock/runtime.py,sha256=uEq_zpCd--zqVAGU95uQt9QXqp2036iWo2lRr1JGlM8,8651
 flock/service.py,sha256=JDdjjPTPH6NFezAr8x6svtqxIGXA7-AyHS11GF57g9Q,11041
 flock/store.py,sha256=H6z1_y5uDp_4UnHWqrxNksyoSGlzeVTgLY3Sv-guSTU,45793
 flock/subscription.py,sha256=0fqjGVAr-3u1azSsXJ-xVjnUgSSYVO2a0Gd_zln2tZA,5422
@@ -17,28 +17,30 @@ flock/utilities.py,sha256=bqTPnFF6E-pDqx1ISswDNEzTU2-ED_URlkyKWLjF3mU,12109
 flock/visibility.py,sha256=Cu2PMBjRtqjiWzlwHLCIC2AUFBjJ2augecG-jvK8ky0,2949
 flock/api/themes.py,sha256=BOj1e0LHx6BDLdnVdXh1LKsbQ_ZeubH9UCoj08dC1yc,1886
 flock/dashboard/__init__.py,sha256=_W6Id_Zb7mkSz0iHY1nfdUqF9p9uV_NyHsU7PFsRnFI,813
-flock/dashboard/collector.py,sha256=ka29inyVWb3TpboboaZT3QQdviSNOKD8Wue7QCYO14w,21478
-flock/dashboard/events.py,sha256=yULfn1H3BdjX_hO0echIpGXpbAj4sVfboeZwrlxMKN0,5571
-flock/dashboard/graph_builder.py,sha256=u5Hp007Wr_v3aQI_0YzTit9hAGDc-gUiilnj-p114uo,21402
+flock/dashboard/collector.py,sha256=m0dh1HNvJsf-9vM9NGpvPz6wYjzSSQdc8UgVCVbMN-k,21685
+flock/dashboard/events.py,sha256=ICqpBKE68HjevJg7GAT7rrUbPV8Adkird34ZC45_oYA,7679
+flock/dashboard/graph_builder.py,sha256=jdiaruce5uRybndlA4aiOXW-gKkHeGtnndzYQ1WyU9Y,32006
 flock/dashboard/launcher.py,sha256=dCfwaeMLtyIkik3aVSEsbBdABS5ADRlKWYkih7sF5hM,8196
-flock/dashboard/service.py,sha256=PzyJS3T3lSoC1sULdfKqUJyu2UUhtSV5xEG0LPhO4qI,39071
+flock/dashboard/service.py,sha256=_jyHQ_hC9sFgj8mwtuW2r8labZ3NsBJ-1FYcKB0qq9E,52410
 flock/dashboard/websocket.py,sha256=_DCZApJPXc8OQnxFDFS9TA9ozq7kM73QByRj-_a8n-8,9508
 flock/dashboard/models/__init__.py,sha256=T4Yz8IXMm7lBqa2HLDSv7WJBtaKcdZIlTrz6GHNFZxs,68
-flock/dashboard/models/graph.py,sha256=t159CMNavFYZB-qvSE5HRh9Zi_HOR4RYc8VzIngpx_E,5316
-flock/dashboard/static_v2/index.html,sha256=iWL-fgTY2egom20DMvSOpuYZ6pC5AVvdNZcj-EvPm5w,422
-flock/dashboard/static_v2/assets/index-DFRnI_mt.js,sha256=PVrBXxY3Igbf9dqtsWoCbhogEhibapLAwlMYV5Gv4pY,764870
+flock/dashboard/models/graph.py,sha256=oQAGAVMV32tim8xscUxZ9nFOci0RvryjdPf1sJgiGxQ,5402
+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=o_k9mnWuxGN2jEL8KQmaBCGi6Aw8hQb9AZPsQRLRw3U,50921
-flock/frontend/README.md,sha256=R1gqm524Xa5PZAkfl-IJDEf6VsBJ6ThrpY7SyDawjog,26232
+flock/engines/dspy_engine.py,sha256=Q2stZi6jMjjNlhXvzmW3m-Y8AdVo1QuNunbnxEZl6rA,52232
+flock/engines/examples/__init__.py,sha256=cDAjF8_NPL7nhpwa_xxgnPYRAXZWppKE2HkxmL8LGAI,126
+flock/engines/examples/simple_batch_engine.py,sha256=RZVuFJHr3j_4dJZc2AXUcjKZJdct0A7UKOSwWgVEKk4,2235
+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=1edo2JDle0if_MljnK4Xto7Q7hhGUEBQAvQFqKy9RzQ,150798
-flock/frontend/package.json,sha256=4hHxn3NhjZnHgVM4tooAC0LnePEuC2QlrdwfgFjIj9Y,1258
+flock/frontend/package-lock.json,sha256=vNOaISeq3EfEDDEsFYPWFaMsqypDgQIE0P_u6tzE0g4,150798
+flock/frontend/package.json,sha256=SFwHeNZ0mS9p4_enSXZNMtuXxSM5cl52dzEr-MuRZ90,1253
 flock/frontend/tsconfig.json,sha256=B9p9jXohg_jrCZAq5_yIHvznpeXHiHQkwUZrVE2oMRA,705
 flock/frontend/tsconfig.node.json,sha256=u5_YWSqeNkZBRBIZ8Q2E2q6bospcyF23mO-taRO7glc,233
 flock/frontend/vite.config.ts,sha256=M76uTsyn7fvHI4NhaGyizOGmml0fJvuhSljOQm_UvGs,566
 flock/frontend/vitest.config.ts,sha256=xSWyGrBv2Cy_5eeZA68NCO5AXS6q8WKZXXzqu2JnXPY,244
-flock/frontend/docs/DESIGN_SYSTEM.md,sha256=xDTKBDikSIyJMP5Lk0gWSimQHeXv8IzIuJR7SLOEdPY,48503
+flock/frontend/docs/DESIGN_SYSTEM.md,sha256=a7hbH7kQCOrOQu3CMTYthTZTrFCQUIRcqtXaYHMkPbo,48498
 flock/frontend/src/App.tsx,sha256=3vwTT_WJP7OUb0LJDVMXfkb5hD-uZZmiGBK2wl1QgeM,5233
 flock/frontend/src/main.tsx,sha256=sfWsPgNn5AyDH4LJJLTz2c5OwOPl0o4oi-FArpqc-W4,354
 flock/frontend/src/vite-env.d.ts,sha256=tDjMtvUVN9uIgSCHe__Jhp0-nZiIV21pkcQuyOjaryw,344
@@ -54,8 +56,8 @@ flock/frontend/src/components/common/KeyboardShortcutsDialog.tsx,sha256=zKrMAWhO
 flock/frontend/src/components/common/LoadingSpinner.module.css,sha256=ziZSTIi4dLECTDNJvnkvpCnvo3CuVZ6STNWsHHoZSU8,1769
 flock/frontend/src/components/common/LoadingSpinner.tsx,sha256=ZtI9BOGQg4t-n923y8m1MkL9H8sDWX3wECjr6cdk51o,766
 flock/frontend/src/components/controls/PublishControl.css,sha256=yr73R7lf1fnq22DoPsOOfe2vM_FiWr-ekr5pZE_-KxA,12504
-flock/frontend/src/components/controls/PublishControl.test.tsx,sha256=AZiFHmInNPidbXX1dSMOxZd2kDAOgxCVB_IuzQu4K2Q,17675
-flock/frontend/src/components/controls/PublishControl.tsx,sha256=P1l9TWkIjYJ2qawHSA-WlOuRsHOuGzKy6GosBfQialo,14729
+flock/frontend/src/components/controls/PublishControl.test.tsx,sha256=1PMNOAcnfdm2mg_7m31MdcZrth_AN0F-G8QT9CMH6AQ,17711
+flock/frontend/src/components/controls/PublishControl.tsx,sha256=fDLR1qYhshUv26MFxHvDwCGQzvPzcByv8ApM-6d97Bw,14739
 flock/frontend/src/components/details/DetailWindowContainer.tsx,sha256=eKfFNBoSSl_JYj6Aaij9a9n6H24oQrfzZtE1uiUr0k8,1868
 flock/frontend/src/components/details/LiveOutputTab.test.tsx,sha256=YyxsBP3QpbeWDGKNGZsOjqLLqUkvuI-L-5tB2Sh7ATc,24160
 flock/frontend/src/components/details/LiveOutputTab.tsx,sha256=4mmN4DxI6rF9g9fVIAqbC8UsTwf4uzdNbPqGvvvP2FM,6908
@@ -84,12 +86,15 @@ flock/frontend/src/components/filters/TimeRangeFilter.test.tsx,sha256=4vkGYNecXc
 flock/frontend/src/components/filters/TimeRangeFilter.tsx,sha256=4-INbQXk0RrDfP4NK1LBNcLQQWhNYos2Ken8cizb114,3311
 flock/frontend/src/components/filters/VisibilityFilter.tsx,sha256=rFS4U90ltzYIUyfVR8NFRDLuTOLZdk_rTIQsXlB9EuI,679
 flock/frontend/src/components/graph/AgentNode.test.tsx,sha256=D2OirlLSd22Ae5ocLLiBkL2lLz3vXtcx0LWAnqRYc58,2058
-flock/frontend/src/components/graph/AgentNode.tsx,sha256=F_lSnQJK8GR1x1US6C1ch-3MNVrzs_sF4IwwYjiy63I,12626
-flock/frontend/src/components/graph/GraphCanvas.tsx,sha256=O1fQKp7B1paDvwlG1nuy0t02aZuiNnj4Cy-qglYj21g,22124
+flock/frontend/src/components/graph/AgentNode.tsx,sha256=S0bZ3tIcxBfVHLBYIcJh-iXpfGMwb31K5aXuOh7Q_Xg,12979
+flock/frontend/src/components/graph/GraphCanvas.tsx,sha256=E0pqDH5eezp14xdfaH_6ggnqAgTe7W_aJVVSQIUIFEw,22416
+flock/frontend/src/components/graph/LogicOperationsDisplay.tsx,sha256=E_z9c5RvE7pOJi8tFrmiLpZzbfeKr8kie-AnUGUKSu8,19862
 flock/frontend/src/components/graph/MessageFlowEdge.tsx,sha256=OWYmmlS5P9yIxfCddEleEd27MA-djMd_3fcQmyT22r4,3914
 flock/frontend/src/components/graph/MessageNode.test.tsx,sha256=xFBdOPQuWGm7_QUROkV8B9iRHEpyqsosxG_6i4K7ThE,1922
 flock/frontend/src/components/graph/MessageNode.tsx,sha256=cirokPB3MKKLwCPtssGbD3FdhpxX5Ie2h1mM4Vv97w0,4114
 flock/frontend/src/components/graph/MiniMap.tsx,sha256=i2lQ51EAp35mwo2C35U6zktwm8o54iKm4MBSN4UJh3Y,1305
+flock/frontend/src/components/graph/PendingBatchEdge.tsx,sha256=8MHs68YmLOocWQ6lxCooeuwCjpwQn5KFdI-pfu5oXx8,4442
+flock/frontend/src/components/graph/PendingJoinEdge.tsx,sha256=nawJ4Hm8JjfJBypdYgAYkd3t4PcaYdzd6aEyFzTC0-Y,4495
 flock/frontend/src/components/graph/TransformEdge.tsx,sha256=dL-FH4a7ujNd7mBgzQvFXrj_KvZeyYXKoEALfnDDCxA,3737
 flock/frontend/src/components/layout/DashboardLayout.css,sha256=CPiz_GqEMx6WDR6FTtlnbLJJPVKezNxdKLM7DJ3ANv8,9409
 flock/frontend/src/components/layout/DashboardLayout.tsx,sha256=GyKvJZX-a3OwNsVgPxP26T-j6khh7B5tGpWrrRb0R1I,10906
@@ -109,9 +114,9 @@ flock/frontend/src/components/settings/AdvancedSettings.tsx,sha256=Ngw5jAIRn3ocX
 flock/frontend/src/components/settings/AppearanceSettings.tsx,sha256=UHH4BcJ9-F-nRJEJf2rzmX0W-0hvmeKo6AYNF3lZPWE,6872
 flock/frontend/src/components/settings/GraphSettings.tsx,sha256=qX1F4hnsxGcCbn3oHP7nsPPMLyETHG3UL55kJ_3tA-s,3815
 flock/frontend/src/components/settings/MultiSelect.tsx,sha256=aFjk8pt18UFHIPh-MXxEepjh-haNYhxEwzMiewSKFbU,7005
-flock/frontend/src/components/settings/SettingsPanel.css,sha256=5ThwfEexKrXEQ_Z73tcA_rg2HxxV2vuptSuuuvwHURY,7067
+flock/frontend/src/components/settings/SettingsPanel.css,sha256=SUUfMHGXVxX8GDDQcb0f6v7ZG983tXa9pC6Xrwctep8,7062
 flock/frontend/src/components/settings/SettingsPanel.tsx,sha256=62GXPCQzYdbk17XYVOx_vCeWlVyFZSxp3w0JTkp3z60,4392
-flock/frontend/src/components/settings/ThemeSelector.tsx,sha256=LDTaqFzWPa7Uw3IRp60l6TI5dLvfsel-Xl3GhuCuf30,10548
+flock/frontend/src/components/settings/ThemeSelector.tsx,sha256=FqyRtWhN8vm6cxfPI1pxFCCuCFDb4YXrwzdufwrXFqM,10538
 flock/frontend/src/components/settings/TracingSettings.tsx,sha256=zHZrUuVQzUANclHfvTndm50zHYX1y-LecFnrloh2Hkc,14224
 flock/frontend/src/hooks/useKeyboardShortcuts.ts,sha256=Dsf64nPtJdW2kV-a-bBpaq1VXZkXyxpioBnI1WIGduM,5019
 flock/frontend/src/hooks/useModulePersistence.test.ts,sha256=kqYlFSzqYK_0jGxeRTeXORZ2KTDo3MdByJ2t2ivbg20,14323
@@ -120,18 +125,18 @@ flock/frontend/src/hooks/useModules.ts,sha256=3p47NfBIOWVuHP6tH5sYKhiqK7TuJIsdB5
 flock/frontend/src/hooks/usePersistence.ts,sha256=_fHxWLCwNunESIeJVqGB3Z-ANosRGwyAiISCtF5TcmY,4728
 flock/frontend/src/services/api.ts,sha256=kNHBHvbSk50M3pUtwDMNYwco5Cd4AbQbGGHkpROYHhw,8529
 flock/frontend/src/services/graphService.test.ts,sha256=wftS4QX-Bw6hogTWXVYaV3F7z6AN94d7iI8jrMVwwkg,11493
-flock/frontend/src/services/graphService.ts,sha256=kgrbNo2Y2UTz1K5NtoVtKrbRkODW3q1orCLBiB477sg,1821
+flock/frontend/src/services/graphService.ts,sha256=MaFdj8S2l7UOkQBkACDv29BuroMy1vJEhliVnsYkmwM,1964
 flock/frontend/src/services/indexeddb.test.ts,sha256=lY1JzyKRd4Kaw135JlO7njy5rpaAsRRXLM8SwYxDhAc,27452
-flock/frontend/src/services/indexeddb.ts,sha256=gSTkrR-JJlN9ovDuLK45uQrYSrS2dwgOcy14C1pvNdY,28708
+flock/frontend/src/services/indexeddb.ts,sha256=2sXodUZAp3jSiS-3a7Bwvkjdjp_Tc47bk5eR_1f9qqw,28703
 flock/frontend/src/services/layout.test.ts,sha256=-KwUxWCum_Rsyc5NIpk99UB3prfAkMO5ksJULhjOiwA,16174
 flock/frontend/src/services/layout.ts,sha256=5WzlOv7OBlQXiUxrv4l1JwaAfHbUK1C99JOT0fQCNRY,9503
 flock/frontend/src/services/themeApplicator.ts,sha256=utRFw-45e1IEOrI6lHkB_E_-5kc2kFKbN-veAUdXiOM,5802
 flock/frontend/src/services/themeService.ts,sha256=ltDAE30KzzVFDQJGm8awN0Go-l16NgTWYOxlvgxvx0E,1743
-flock/frontend/src/services/websocket.ts,sha256=P-qXMNfrC0kY3cOKhZBr_AG3lzEMcLUJ_fKyjU0xgyw,22753
+flock/frontend/src/services/websocket.ts,sha256=Zx6xG9z4toNwt2wJ8Dit5mTVqqzHabIl_M-woi3ZFoY,26465
 flock/frontend/src/store/filterStore.test.ts,sha256=0KEaZI1aucfGwZSP76zmJUR2Xl0qqfXqImo-JuSdp4c,8868
 flock/frontend/src/store/filterStore.ts,sha256=mJYzgdm_FFyq-irqfZ7O4-fLrPuRVPBgM7fcIRlP6_s,8967
-flock/frontend/src/store/graphStore.test.ts,sha256=2Un9PaeoPyDqbodde8RPauWoTSc-Fb4ZOfXsvbe9uAY,19009
-flock/frontend/src/store/graphStore.ts,sha256=eYRB-yIDzUdw9nMAKScyuEPTvGBfCaqQ2UJDGSxLL6E,15981
+flock/frontend/src/store/graphStore.test.ts,sha256=YOg7MTYaIDQPnzV0qx9m1A7GgHNXRMXgE5AWDlYdCt4,19058
+flock/frontend/src/store/graphStore.ts,sha256=7qI2tQpdEgZNbJ2GguIi9IJL4iyj2Bo6_hH2P7hQjME,17312
 flock/frontend/src/store/moduleStore.test.ts,sha256=VxkoEPu0-B3ln20oBk3xLN-c7J55hMYLN2wQQPs4q-k,7800
 flock/frontend/src/store/moduleStore.ts,sha256=Y2iTxYikvzuZTGBHtFNofcenzljcHvDUDcrZ093XdPA,2361
 flock/frontend/src/store/settingsStore.ts,sha256=JNB25kkKxOlaSY1jFTM64BGynhUZ98jZL1mM87PLCF0,5995
@@ -141,10 +146,10 @@ flock/frontend/src/store/uiStore.ts,sha256=H5aH8YfaxOTfm3zCrT9A1QdC2dnHJWPUUg8uV
 flock/frontend/src/store/wsStore.ts,sha256=vKaGd6H7UONN7A-8tCTOgdH8X2LxrZmVbZ7hRnfGQ2c,936
 flock/frontend/src/styles/index.css,sha256=HVMvVEMvlFk8_vqxBdt8CzkleXkV-oSUcQUzom588PM,231
 flock/frontend/src/styles/scrollbar.css,sha256=OHH2nryMANNvuJBloG_t1BPY_BtKMSb36Df4q2X47Rk,1207
-flock/frontend/src/styles/variables.css,sha256=EcOH8mb8ZIoGZU5c-K_2zcuGdtbu_vQWk_gC-X6vtmk,13889
+flock/frontend/src/styles/variables.css,sha256=18UzMGPn_GOKWa2eXe1u0lJLI4yRLM7LjONASATwo6Q,13884
 flock/frontend/src/test/setup.ts,sha256=pG1mhRrywFboBf3VdL9ew62xGBxDxeQfChxZLjOK_mQ,36
 flock/frontend/src/types/filters.ts,sha256=zPa4AvL9xudvB6RZsqJCllMoLTnvPuBhqU6vLeWO89Y,1041
-flock/frontend/src/types/graph.ts,sha256=dyvBEFXl490yGuCqBLMu-Pg82GuYBN-1E6hwE-OJpKM,2265
+flock/frontend/src/types/graph.ts,sha256=mz62owu0OXO-xbzCPX2_arRRv0_Kp79tj5Ek-TqdHhI,4615
 flock/frontend/src/types/modules.ts,sha256=l5ThtDoD1AxXLjGya-EdQM3eAU55Q0J4XZHQsFrUWws,341
 flock/frontend/src/types/theme.ts,sha256=bjV2zWxBJilEXeosjSSirw05dL7zICShUDx2H0oA5J8,903
 flock/frontend/src/utils/artifacts.ts,sha256=JjbNXKgcBaUJdR7VKDi0LK0T3d-ltYt4HHbiQNB3rmI,790
@@ -185,8 +190,8 @@ flock/mcp/types/handlers.py,sha256=6ukkSMv1VZSfk2QDUiJnm8xifHnQvWZsxWXqN21BYSg,7
 flock/mcp/types/types.py,sha256=ZbzbVihABFnfmZz2X-CCN7hQDzaSY0T-en43PFbFwQQ,11469
 flock/mcp/util/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 flock/mcp/util/helpers.py,sha256=jO8DqqSb_S4dyvsxv5vlMGRoMx92Su_5-Uv17gQNuLU,740
-flock/patches/__init__.py,sha256=2turkIzq6C_DpIKDwah7aPd-1RFOAGX7dxTkaBd9X4w,193
-flock/patches/dspy_streaming_patch.py,sha256=1vJ7t_PlBBza6MAQPiBhFn2A0k42tdYGs-WpC77BmDA,2762
+flock/patches/__init__.py,sha256=KfRTpO_rz547iKxJDknymar1P3lS_8AhDh-sR1BkcZ0,194
+flock/patches/dspy_streaming_patch.py,sha256=4v24wweqSP6r9GGIijMJgvZ_HgV92e10aPq7kaYNYDs,2763
 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
@@ -524,8 +529,8 @@ flock/themes/zenburned.toml,sha256=UEmquBbcAO3Zj652XKUwCsNoC2iQSlIh-q5c6DH-7Kc,1
 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=yVHhlIIIoYKziI5UyT_zvQb4G-NsxCTgLwA1wXXTTj4,9047
-flock_core-0.5.3.dist-info/METADATA,sha256=0Ec9QS5oTYf1t5r_FSpd3xAu3JXapC5FjHDP05GsRJA,39146
-flock_core-0.5.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-flock_core-0.5.3.dist-info/entry_points.txt,sha256=UQdPmtHd97gSA_IdLt9MOd-1rrf_WO-qsQeIiHWVrp4,42
-flock_core-0.5.3.dist-info/licenses/LICENSE,sha256=U3IZuTbC0yLj7huwJdldLBipSOHF4cPf6cUOodFiaBE,1072
-flock_core-0.5.3.dist-info/RECORD,,
+flock_core-0.5.5.dist-info/METADATA,sha256=t-87LUTaHtfmkBW4U37oAhenOGcoq3WITQfRpuvrgsc,39584
+flock_core-0.5.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+flock_core-0.5.5.dist-info/entry_points.txt,sha256=UQdPmtHd97gSA_IdLt9MOd-1rrf_WO-qsQeIiHWVrp4,42
+flock_core-0.5.5.dist-info/licenses/LICENSE,sha256=U3IZuTbC0yLj7huwJdldLBipSOHF4cPf6cUOodFiaBE,1072
+flock_core-0.5.5.dist-info/RECORD,,