flock-core 0.5.22__tar.gz → 0.5.23__tar.gz

{flock_core-0.5.22 → flock_core-0.5.23}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flock-core
-Version: 0.5.22
+Version: 0.5.23
 Summary: Flock: A declrative framework for building and orchestrating AI agents.
 Author-email: Andre Ratzenberger <andre.ratzenberger@whiteduck.de>
 License: MIT
@@ -43,7 +43,7 @@ Description-Content-Type: text/markdown
   <a href="LICENSE" target="_blank"><img alt="License" src="https://img.shields.io/github/license/whiteducksoftware/flock?style=for-the-badge"></a>
   <a href="https://whiteduck.de" target="_blank"><img alt="Built by white duck" src="https://img.shields.io/badge/Built%20by-white%20duck%20GmbH-white?style=for-the-badge&labelColor=black"></a>
   <a href="https://codecov.io/gh/whiteducksoftware/flock" target="_blank"><img alt="Test Coverage" src="https://codecov.io/gh/whiteducksoftware/flock/branch/main/graph/badge.svg?token=YOUR_TOKEN_HERE&style=for-the-badge"></a>
-  <img alt="Tests" src="https://img.shields.io/badge/tests-1300+-brightgreen?style=for-the-badge">
+  <img alt="Tests" src="https://img.shields.io/badge/tests-1400+-brightgreen?style=for-the-badge">
 </p>
 
 ---

{flock_core-0.5.22 → flock_core-0.5.23}/README.md

@@ -8,7 +8,7 @@
   <a href="LICENSE" target="_blank"><img alt="License" src="https://img.shields.io/github/license/whiteducksoftware/flock?style=for-the-badge"></a>
   <a href="https://whiteduck.de" target="_blank"><img alt="Built by white duck" src="https://img.shields.io/badge/Built%20by-white%20duck%20GmbH-white?style=for-the-badge&labelColor=black"></a>
   <a href="https://codecov.io/gh/whiteducksoftware/flock" target="_blank"><img alt="Test Coverage" src="https://codecov.io/gh/whiteducksoftware/flock/branch/main/graph/badge.svg?token=YOUR_TOKEN_HERE&style=for-the-badge"></a>
-  <img alt="Tests" src="https://img.shields.io/badge/tests-1300+-brightgreen?style=for-the-badge">
+  <img alt="Tests" src="https://img.shields.io/badge/tests-1400+-brightgreen?style=for-the-badge">
 </p>
 
 ---

{flock_core-0.5.22 → flock_core-0.5.23}/examples/08-semantic/01_intelligent_ticket_routing.py

@@ -38,7 +38,6 @@ class SupportTicket(BaseModel):
 
     message: str = Field(description="The customer's issue or question")
     customer_id: str = Field(description="Customer identifier")
-    category: str | None = Field(default=None, description="Auto-assigned category")
 
 
 @flock_type
@@ -99,7 +98,7 @@ billing_team = (
 # Matches: "can't login", "error message", "not working", "broken feature"
 tech_support = (
     flock.agent("tech_support")
-    .consumes(SupportTicket, semantic_match="technical issue error bug problem")
+    .consumes(SupportTicket, semantic_match="technical issue error bug problem device")
     .publishes(TechnicalResponse)
 )
 
@@ -130,7 +129,7 @@ async def main_cli():
     print("   Expected Route: → Security Team")
 
     await flock.publish(security_ticket)
-    await flock.run_until_idle()
+    await flock.run_until_idle(wait_for_input=True)
 
     # Test Case 2: Billing Issue
     print("\n📋 Ticket 2: Billing Issue")
@@ -142,7 +141,7 @@ async def main_cli():
     print("   Expected Route: → Billing Team")
 
     await flock.publish(billing_ticket)
-    await flock.run_until_idle()
+    await flock.run_until_idle(wait_for_input=True)
 
     # Test Case 3: Technical Issue
     print("\n📋 Ticket 3: Technical Problem")
@@ -154,7 +153,7 @@ async def main_cli():
     print("   Expected Route: → Tech Support")
 
     await flock.publish(tech_ticket)
-    await flock.run_until_idle()
+    await flock.run_until_idle(wait_for_input=True)
 
     # Test Case 4: General Question
     print("\n📋 Ticket 4: General Inquiry")

{flock_core-0.5.22 → flock_core-0.5.23}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "flock-core"
-version = "0.5.22"
+version = "0.5.23"
 description = "Flock: A declrative framework for building and orchestrating AI agents."
 readme = "README.md"
 requires-python = ">=3.12"

{flock_core-0.5.22 → flock_core-0.5.23}/src/flock/core/agent.py

@@ -226,11 +226,7 @@ class Agent(metaclass=AutoTracedMeta):
             comp_name = self._component_display_name(component)
             priority = getattr(component, "priority", 0)
             logger.info(
-                "Agent %s: utility added: component=%s, priority=%s, total_utilities=%s",
-                self.name,
-                comp_name,
-                priority,
-                len(self.utilities),
+                f"Agent {self.name}: utility added: component={comp_name}, priority={priority}, total_utilities={len(self.utilities)}"
             )
         self.utilities.sort(key=lambda comp: getattr(comp, "priority", 0))
 

{flock_core-0.5.22 → flock_core-0.5.23}/src/flock/core/orchestrator.py

@@ -492,13 +492,17 @@ class Flock(metaclass=AutoTracedMeta):
 
     # Runtime --------------------------------------------------------------
 
-    async def run_until_idle(self) -> None:
+    async def run_until_idle(self, *, wait_for_input: bool = False) -> None:
         """Wait for all scheduled agent tasks to complete.
 
         This method blocks until the blackboard reaches a stable state where no
         agents are queued for execution. Essential for batch processing and ensuring
         all agent cascades complete before continuing.
 
+        Args:
+            wait_for_input: If True, waits for user input before returning (default: False).
+                Useful for debugging or step-by-step execution.
+
         Note:
             Automatically resets circuit breaker counters and shuts down MCP connections
             when idle. Used with publish() for event-driven workflows.
@@ -514,6 +518,12 @@ class Flock(metaclass=AutoTracedMeta):
             >>> await flock.publish_many([task1, task2, task3])
             >>> await flock.run_until_idle()  # All tasks processed in parallel
 
+            >>> # Step-by-step execution with user prompts
+            >>> await flock.publish(task1)
+            >>> await flock.run_until_idle(wait_for_input=True)  # Pauses for user input
+            >>> await flock.publish(task2)
+            >>> await flock.run_until_idle(wait_for_input=True)  # Pauses again
+
         See Also:
             - publish(): Event-driven artifact publishing
             - publish_many(): Batch publishing for parallel execution
@@ -553,6 +563,12 @@ class Flock(metaclass=AutoTracedMeta):
         # Automatically shutdown MCP connections when idle
         await self.shutdown(include_components=False)
 
+        # Wait for user input if requested
+        if wait_for_input:
+            # Use asyncio.to_thread to avoid blocking the event loop
+            # since input() is a blocking I/O operation
+            await asyncio.to_thread(input, "Press any key to continue....")
+
     async def direct_invoke(
         self, agent: Agent, inputs: Sequence[BaseModel | Mapping[str, Any] | Artifact]
     ) -> list[Artifact]:

{flock_core-0.5.22 → flock_core-0.5.23}/src/flock/semantic/embedding_service.py

@@ -4,13 +4,13 @@ This module provides a singleton service for generating and caching embeddings
 using sentence-transformers.
 """
 
-import logging
+from flock.logging.logging import get_logger
 from collections import OrderedDict
 
 import numpy as np
 
 
-logger = logging.getLogger(__name__)
+logger = get_logger(__name__)
 
 
 class LRUCache:
@@ -213,6 +213,10 @@ class EmbeddingService:
 
         similarity = dot_product / (norm1 * norm2)
 
+        logger.debug(
+            f"Computed similarity: {similarity:.4f} between texts '{text1}' and '{text2}'",
+        )
+
         # Clamp to [0, 1] and handle floating point errors
         return float(max(0.0, min(1.0, similarity)))
 

{flock_core-0.5.22 → flock_core-0.5.23}/uv.lock

@@ -847,7 +847,7 @@ wheels = [
 
 [[package]]
 name = "flock-core"
-version = "0.5.22"
+version = "0.5.23"
 source = { editable = "." }
 dependencies = [
     { name = "aiosqlite" },