flock-core 0.5.0b3__tar.gz → 0.5.0b5__tar.gz

{flock_core-0.5.0b3 → flock_core-0.5.0b5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flock-core
-Version: 0.5.0b3
+Version: 0.5.0b5
 Summary: Declarative LLM Orchestration at Scale
 Author-email: Andre Ratzenberger <andre.ratzenberger@whiteduck.de>
 License-File: LICENSE

{flock_core-0.5.0b3 → flock_core-0.5.0b5}/docs/architecture_report.md

@@ -102,7 +102,7 @@ graph TB
     subgraph "FlockAgent (Minimal Core)"
         Agent[FlockAgent]
         ComponentsList[components: list]
-        NextAgent[next_agent: str | None]
+        NextAgent["next_agent: str | None"]
         Config[config: FlockAgentConfig]
     end
     
@@ -206,7 +206,7 @@ graph LR
     subgraph "Key Improvements"
         SRP[Single Responsibility Principle]
         Lazy[Lazy Loading]
-        Consistency[Consistent Naming (_helper)]
+        Consistency["Consistent Naming (_helper)"]
         Maintainability[Easier Maintenance]
     end
     

{flock_core-0.5.0b3 → flock_core-0.5.0b5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "flock-core"
-version = "0.5.0b3"
+version = "0.5.0b5"
 description = "Declarative LLM Orchestration at Scale"
 readme = "README.md"
 authors = [

{flock_core-0.5.0b3 → flock_core-0.5.0b5}/requirements.txt

@@ -1,34 +1,32 @@
 # This file was autogenerated by uv via the following command:
 #    uv pip compile --no-deps -o requirements.txt pyproject.toml
-azure-search-documents==11.5.2
+aiosqlite==0.21.0
     # via flock-core (pyproject.toml)
-chromadb==0.6.3
+azure-data-tables==12.7.0
     # via flock-core (pyproject.toml)
 cloudpickle==3.1.1
     # via flock-core (pyproject.toml)
-datasets==3.5.0
+croniter==6.0.0
     # via flock-core (pyproject.toml)
 devtools==0.12.2
     # via flock-core (pyproject.toml)
-dspy==2.6.16
-    # via flock-core (pyproject.toml)
-duckduckgo-search==7.3.2
+dspy==2.6.23
     # via flock-core (pyproject.toml)
 fastapi==0.115.12
     # via flock-core (pyproject.toml)
 httpx==0.28.1
     # via flock-core (pyproject.toml)
-litellm==1.63.7
+litellm==1.69.3
     # via flock-core (pyproject.toml)
 loguru==0.7.3
     # via flock-core (pyproject.toml)
-matplotlib==3.10.1
+markdown2==2.5.3
     # via flock-core (pyproject.toml)
-msgpack==1.1.0
+mcp==1.9.2
     # via flock-core (pyproject.toml)
-nltk==3.9.1
+msgpack==1.1.0
     # via flock-core (pyproject.toml)
-notion-client==2.3.0
+openai==1.75.0
     # via flock-core (pyproject.toml)
 opentelemetry-api==1.30.0
     # via flock-core (pyproject.toml)
@@ -42,6 +40,8 @@ opentelemetry-instrumentation-logging==0.51b0
     # via flock-core (pyproject.toml)
 opentelemetry-sdk==1.30.0
     # via flock-core (pyproject.toml)
+opik==1.7.28
+    # via flock-core (pyproject.toml)
 pandas==2.2.3
     # via flock-core (pyproject.toml)
 pillow==11.1.0
@@ -50,7 +50,7 @@ prometheus-client==0.21.1
     # via flock-core (pyproject.toml)
 psutil==7.0.0
     # via flock-core (pyproject.toml)
-pydantic==2.10.6
+pydantic==2.10.5
     # via flock-core (pyproject.toml)
 pydantic-settings==2.8.1
     # via flock-core (pyproject.toml)
@@ -60,18 +60,16 @@ python-decouple==3.8
     # via flock-core (pyproject.toml)
 python-dotenv==1.1.0
     # via flock-core (pyproject.toml)
-python-fasthtml==0.12.12
-    # via flock-core (pyproject.toml)
 pyyaml==6.0.2
     # via flock-core (pyproject.toml)
 questionary==2.1.0
     # via flock-core (pyproject.toml)
 rich==13.9.4
     # via flock-core (pyproject.toml)
-sentence-transformers==4.0.1
-    # via flock-core (pyproject.toml)
 temporalio==1.9.0
     # via flock-core (pyproject.toml)
+thefuzz==0.22.1
+    # via flock-core (pyproject.toml)
 tiktoken==0.9.0
     # via flock-core (pyproject.toml)
 toml==0.10.2
@@ -80,5 +78,7 @@ tqdm==4.67.1
     # via flock-core (pyproject.toml)
 uvicorn==0.34.0
     # via flock-core (pyproject.toml)
-zep-python==2.0.2
+wd-di==0.2.14
+    # via flock-core (pyproject.toml)
+websockets==15.0.1
     # via flock-core (pyproject.toml)

{flock_core-0.5.0b3 → flock_core-0.5.0b5}/src/flock/cli/execute_flock.py

@@ -142,7 +142,7 @@ def execute_flock(flock: Flock):
 
         # Run the Flock
         result = flock.run(
-            start_agent=start_agent_name,
+            agent=start_agent_name,
             input=input_data,
         )
 

{flock_core-0.5.0b3 → flock_core-0.5.0b5}/src/flock/core/api/endpoints.py

@@ -89,7 +89,7 @@ def create_api_router() -> APIRouter:
                     typed_inputs = inputs_task # Simplified for now
 
                     result = await flock_instance.run_async(
-                        start_agent=agent_name_task, input=typed_inputs
+                        agent=agent_name_task, input=typed_inputs
                     )
                     run_store.update_run_result(run_id_task, result)
                 except Exception as e_task:

{flock_core-0.5.0b3 → flock_core-0.5.0b5}/src/flock/core/api/service.py

@@ -33,7 +33,7 @@ class FlockApiService:
             )
             # Flock.run_async now handles context creation and execution
             result = await self.flock.run_async(
-                start_agent=agent_name, input=typed_inputs
+                agent=agent_name, input=typed_inputs
             )
             self.run_store.update_run_result(run_id, result)
 
@@ -100,7 +100,7 @@ class FlockApiService:
                         try:
                             # Call Flock's run_async for a single item
                             item_result = await self.flock.run_async(
-                                start_agent=request.agent_name,
+                                agent=request.agent_name,
                                 input=item_inputs,
                                 box_result=request.box_results,
                             )

{flock_core-0.5.0b3 → flock_core-0.5.0b5}/src/flock/core/evaluation/utils.py

@@ -17,6 +17,7 @@ from opik.evaluation import evaluate
 
 from flock.core.flock import Flock
 from flock.core.flock_agent import FlockAgent
+
 # Legacy FlockEvaluator import removed
 from flock.core.logging.logging import get_logger
 
@@ -58,7 +59,7 @@ def evaluate_with_opik(
 
         # Use the shared Flock instance instead of creating a new one
         result_flock = shared_flock.run(
-            start_agent=start_agent, input=agent_input, box_result=False
+            agent=start_agent, input=agent_input, box_result=False
         )
 
         # agent_output = result_flock.get(answer_mapping[key], "No answer found")

{flock_core-0.5.0b3 → flock_core-0.5.0b5}/src/flock/core/execution/batch_executor.py

@@ -228,7 +228,7 @@ class BatchProcessor:
             try:
                 # Use the synchronous wrapper to avoid nested event-loop issues inside threads
                 result = self.flock.run(
-                    start_agent=start_agent,
+                    agent=start_agent,
                     input=full_input,
                     box_result=box_results,
                 )

{flock_core-0.5.0b3 → flock_core-0.5.0b5}/src/flock/core/execution/evaluation_executor.py

@@ -188,7 +188,7 @@ class EvaluationExecutor:
                 try:
                     # Run the agent/flock for this item
                     agent_output = await self.flock.run_async(
-                        start_agent=start_agent,  # Name or instance
+                        agent=start_agent,  # Name or instance
                         input=agent_inputs_with_static,
                         box_result=True,  # Use Box for easier access via dot notation
                         # context=... # Assuming isolated context for now

{flock_core-0.5.0b3 → flock_core-0.5.0b5}/src/flock/core/execution/opik_executor.py

@@ -64,7 +64,7 @@ class OpikExecutor:
 
         # Evaluation task
         def evaluation_task(dataset_item):
-          flock_result = self.flock.run(start_agent=start_agent, input=dataset_item, box_result=False)
+          flock_result = self.flock.run(agent=start_agent, input=dataset_item, box_result=False)
 
           result = {
               "input": dataset_item.get("test"),

{flock_core-0.5.0b3 → flock_core-0.5.0b5}/src/flock/core/flock.py

@@ -279,7 +279,7 @@ class Flock(BaseModel, Serializable):
             agent_input = {self.benchmark_input_field: msg_content}
 
             result = await self.run_async(
-                start_agent=self.benchmark_agent_name,
+                agent=self.benchmark_agent_name,
                 input=agent_input,
                 box_result=False,
             )
@@ -355,7 +355,7 @@ class Flock(BaseModel, Serializable):
 
     def run(
         self,
-        start_agent: FlockAgent | str | None = None,
+        agent: FlockAgent | str | None = None,
         input: dict | None = None,
         context: FlockContext | None = None,
         run_id: str = "",
@@ -366,7 +366,7 @@ class Flock(BaseModel, Serializable):
     ) -> Box | dict:
         """Synchronous execution wrapper."""
         return self._execution.run(
-            start_agent=start_agent,
+            agent=agent,
             input=input,
             context=context,
             run_id=run_id,
@@ -378,7 +378,7 @@ class Flock(BaseModel, Serializable):
 
     async def run_async(
         self,
-        start_agent: FlockAgent | str | None = None,
+        agent: FlockAgent | str | None = None,
         input: dict | None = None,
         context: FlockContext | None = None,
         run_id: str = "",
@@ -389,7 +389,7 @@ class Flock(BaseModel, Serializable):
     ) -> Box | dict:
         """Entry point for running an agent system asynchronously."""
         return await self._execution.run_async(
-            start_agent=start_agent,
+            agent=agent,
             input=input,
             context=context,
             run_id=run_id,

{flock_core-0.5.0b3 → flock_core-0.5.0b5}/src/flock/core/flock_scheduler.py

@@ -76,7 +76,7 @@ class FlockScheduler:
         logger.info(f"Triggering scheduled agent '{agent.name}' at {trigger_time.isoformat()}")
         try:
             # Input for a scheduled agent could include the trigger time
-            await self.flock.run_async(start_agent=agent.name, input={"trigger_time": trigger_time})
+            await self.flock.run_async(agent=agent.name, input={"trigger_time": trigger_time})
             logger.info(f"Scheduled agent '{agent.name}' finished successfully.")
         except Exception as e:
             logger.error(f"Error running scheduled agent '{agent.name}': {e}\n{traceback.format_exc()}")

{flock_core-0.5.0b3 → flock_core-0.5.0b5}/src/flock/core/orchestration/flock_execution.py

@@ -57,7 +57,7 @@ class FlockExecution:
 
     def run(
         self,
-        start_agent: "FlockAgent | str | None" = None,
+        agent: "FlockAgent | str | None" = None,
         input: dict | None = None,
         context: FlockContext | None = None,
         run_id: str = "",
@@ -69,7 +69,7 @@ class FlockExecution:
         """Synchronous execution wrapper."""
         return self._run_sync(
             self.run_async(
-                start_agent=start_agent,
+                agent=agent,
                 input=input,
                 context=context,
                 run_id=run_id,
@@ -82,7 +82,7 @@ class FlockExecution:
 
     async def run_async(
         self,
-        start_agent: "FlockAgent | str | None" = None,
+        agent: "FlockAgent | str | None" = None,
         input: dict | None = None,
         context: FlockContext | None = None,
         run_id: str = "",
@@ -120,7 +120,7 @@ class FlockExecution:
                         )
 
             # Determine starting agent name
-            start_agent_name = self._resolve_start_agent(start_agent)
+            start_agent_name = self._resolve_start_agent(agent)
 
             # Setup execution context and input
             run_input = input if input is not None else self.flock._start_input
@@ -179,7 +179,7 @@ class FlockExecution:
                 }
                 return Box(error_output) if box_result else error_output
 
-    def _resolve_start_agent(self, start_agent: "FlockAgent | str | None") -> str:
+    def _resolve_start_agent(self, agent: "FlockAgent | str | None") -> str:
         """Resolve the start agent name from various input types."""
         from flock.core.flock_agent import FlockAgent as ConcreteFlockAgent
         from flock.core.registry import get_registry
@@ -188,12 +188,12 @@ class FlockExecution:
 
         # Determine starting agent name
         start_agent_name: str | None = None
-        if isinstance(start_agent, ConcreteFlockAgent):
-            start_agent_name = start_agent.name
+        if isinstance(agent, ConcreteFlockAgent):
+            start_agent_name = agent.name
             if start_agent_name not in self.flock._agents:  # Add if not already present
-                self.flock.add_agent(start_agent)
-        elif isinstance(start_agent, str):
-            start_agent_name = start_agent
+                self.flock.add_agent(agent)
+        elif isinstance(agent, str):
+            start_agent_name = agent
         else:  # start_agent is None
             start_agent_name = self.flock._start_agent_name
 

{flock_core-0.5.0b3 → flock_core-0.5.0b5}/src/flock/core/util/hydrator.py

@@ -259,7 +259,7 @@ async def _run_hydration_agent(
 
         # Run agent
         result = await temp_flock.run_async(
-            start_agent=agent_name,
+            agent=agent_name,
             input=agent_input_data,
             box_result=False,
         )

{flock_core-0.5.0b3 → flock_core-0.5.0b5}/src/flock/webapp/app/chat.py

@@ -473,7 +473,7 @@ async def chat_send_shared(
         if frozen_chat_cfg.history_key: run_input[frozen_chat_cfg.history_key] = [h["text"] for h in history if h.get("role") == "user" or h.get("role") == "bot"]
 
         try:
-            result_dict = await flock_inst.run_async(start_agent=bot_agent, input=run_input, box_result=False)
+            result_dict = await flock_inst.run_async(agent=bot_agent, input=run_input, box_result=False)
             if frozen_chat_cfg.response_key:
                 bot_text = str(result_dict.get(frozen_chat_cfg.response_key, result_dict))
             else:

{flock_core-0.5.0b3 → flock_core-0.5.0b5}/src/flock/webapp/app/services/flock_service.py

@@ -281,7 +281,7 @@ async def run_current_flock_service(
         logger.info(f"Executing agent '{start_agent_name}' from flock '{current_flock.name}' using app_state.")
         # Direct execution using the flock from app_state
         result = await current_flock.run_async(
-            start_agent=start_agent_name, input=inputs, box_result=False
+            agent=start_agent_name, input=inputs, box_result=False
         )
         # Store run details using the run_store from app_state
         if hasattr(run_store, "add_run_details"): # Check if RunStore has this method

{flock_core-0.5.0b3 → flock_core-0.5.0b5}/tests/core/test_flock_core.py

@@ -356,7 +356,7 @@ async def test_run_async_temporal_uses_workflow_config(simple_agent, mocker):
 
     input_data = {"query": "test"}
     # 3. Run the flock
-    await flock_with_config.run_async(start_agent="agent1", input=input_data, box_result=False)
+    await flock_with_config.run_async(agent="agent1", input=input_data, box_result=False)
 
     # 4. Assert run_temporal_workflow was called correctly
     mock_temporal_exec.assert_awaited_once()
@@ -459,7 +459,7 @@ async def test_run_async_temporal_no_in_process_worker(basic_flock, simple_agent
     )
 
     # Run
-    await flock_no_worker.run_async(start_agent="agent1", input={"query": "test"}, box_result=False)
+    await flock_no_worker.run_async(agent="agent1", input={"query": "test"}, box_result=False)
 
     # Assert: setup_worker should NOT have been called
     mock_setup_worker.assert_not_awaited()

{flock_core-0.5.0b3 → flock_core-0.5.0b5}/tests/serialization/test_enhanced_serialization.py

@@ -70,7 +70,7 @@ def test_serialization_with_custom_type():
         # Try running the loaded Flock (this will validate the TestPerson type is available)
         # Just a basic smoke test - not testing actual output
         result = loaded_flock.run(
-            start_agent="person_agent",
+            agent="person_agent",
             input={"query": "Get a test person"},
         )
         

{flock_core-0.5.0b3 → flock_core-0.5.0b5}/tests/serialization/test_file_path_serialization.py

@@ -44,7 +44,7 @@ def test_component_file_path_serialization():
         
         # Basic smoke test - can we run the agent?
         result = loaded_flock.run(
-            start_agent="test_agent",
+            agent="test_agent",
             input={"query": "Test query"},
         )
         

{flock_core-0.5.0b3 → flock_core-0.5.0b5}/tests/serialization/test_nested_serialization.py

@@ -75,7 +75,7 @@ def test_nested_type_serialization():
         
         # Try running the loaded Flock (this will validate all nested types are available)
         result = loaded_flock.run(
-            start_agent="company_agent",
+            agent="company_agent",
             input={"query": "Get a test company"},
         )