flock-core 0.5.0b28__py3-none-any.whl → 0.5.56b0__py3-none-any.whl

flock/workflow/temporal_config.py

@@ -1,96 +0,0 @@
-# src/flock/config/temporal_config.py
-
-"""Pydantic models for configuring Temporal execution settings."""
-
-from __future__ import annotations
-
-from datetime import timedelta
-from typing import TYPE_CHECKING
-
-# Conditionally import for type hinting only
-if TYPE_CHECKING:
-    from temporalio.common import RetryPolicy
-
-# Note: Importing temporalio types directly into config models can complicate serialization
-# if these models are meant to be purely data containers (e.g., for YAML/JSON).
-# We define the structure and provide a helper method to convert to the actual Temporal object.
-# Be careful if using workflow/activity decorators directly on methods within these config models.
-from pydantic import BaseModel, Field
-
-
-class TemporalRetryPolicyConfig(BaseModel):
-    """Configuration parameters for Temporal Retry Policies."""
-
-    initial_interval: timedelta = Field(
-        default=timedelta(seconds=1),
-        description="Initial delay before the first retry.",
-    )
-    backoff_coefficient: float = Field(
-        default=2.0, description="Multiplier for the delay between retries."
-    )
-    maximum_interval: timedelta | None = Field(
-        default=timedelta(seconds=100),
-        description="Maximum delay between retries.",
-    )
-    maximum_attempts: int = Field(
-        default=3,
-        description="Maximum number of retry attempts (0 means no retries after first failure).",
-    )
-    non_retryable_error_types: list[str] = Field(
-        default_factory=list,
-        description="List of error type names (strings) that should not be retried.",
-    )
-
-    # Helper to convert to actual Temporalio object when needed (e.g., in workflow/executor)
-    def to_temporalio_policy(self) -> RetryPolicy:
-        # Import locally to avoid making temporalio a hard dependency of the config module itself
-        # The type hint RetryPolicy is now available due to TYPE_CHECKING block
-        from temporalio.common import RetryPolicy
-
-        return RetryPolicy(
-            initial_interval=self.initial_interval,
-            backoff_coefficient=self.backoff_coefficient,
-            maximum_interval=self.maximum_interval,
-            maximum_attempts=self.maximum_attempts,
-            non_retryable_error_types=self.non_retryable_error_types,
-        )
-
-
-class TemporalWorkflowConfig(BaseModel):
-    """Configuration specific to Temporal Workflow Execution for a Flock."""
-
-    task_queue: str = Field(
-        default="flock-queue",
-        description="Default task queue for the workflow execution.",
-    )
-    workflow_execution_timeout: timedelta | None = Field(
-        default=None,  # Default to no timeout (Temporal server default)
-        description="Total time limit for the workflow execution.",
-    )
-    workflow_run_timeout: timedelta | None = Field(
-        default=None,  # Default to no timeout (Temporal server default)
-        description="Time limit for a single workflow run attempt.",
-    )
-    # Default retry policy for activities if not specified per-agent
-    default_activity_retry_policy: TemporalRetryPolicyConfig = Field(
-        default_factory=TemporalRetryPolicyConfig,
-        description="Default retry policy applied to activities if not overridden by the agent.",
-    )
-
-
-class TemporalActivityConfig(BaseModel):
-    """Configuration specific to Temporal Activity Execution (per Agent)."""
-
-    task_queue: str | None = Field(
-        default=None,
-        description="Specific task queue for this agent's activity execution (overrides workflow default).",
-    )
-    start_to_close_timeout: timedelta | None = Field(
-        default=timedelta(minutes=5),  # Default to 5 minutes
-        description="Time limit for a single activity attempt.",
-    )
-    retry_policy: TemporalRetryPolicyConfig | None = Field(
-        default=None,
-        description="Specific retry policy for this activity (overrides workflow default).",
-    )
-    # Other timeouts like schedule_to_start, heartbeat_timeout could be added here if needed

flock/workflow/temporal_setup.py

@@ -1,68 +0,0 @@
-import uuid
-from typing import Optional
-
-from temporalio.client import Client
-from temporalio.worker import Worker
-from flock.config import TEMPORAL_SERVER_URL
-
-
-async def create_temporal_client(server_address: Optional[str] = None) -> Client:
-    """Create a Temporal client using configured server address.
-
-    Args:
-        server_address: Optional override for the Temporal server endpoint. If not
-            provided, falls back to flock.config.TEMPORAL_SERVER_URL.
-    """
-    address = server_address or TEMPORAL_SERVER_URL
-    client = await Client.connect(address)
-    return client
-
-
-async def setup_worker(
-    client: Client, task_queue: str, workflow: type, activities: list
-) -> Worker:
-    """Creates and configures a worker instance, but does not run it.
-
-    Args:
-        client: The Temporal client to associate with the worker.
-        task_queue: The task queue the worker should listen on.
-        workflow: The workflow class definition.
-        activities: A list of activity functions.
-
-    Returns:
-        A configured Worker instance.
-    """
-    # Creates and configures the worker instance
-    worker = Worker(
-        client,
-        task_queue=task_queue,
-        workflows=[workflow],
-        activities=activities,
-    )
-    return worker  # Return the configured worker instance
-
-
-async def run_worker(client: Client, task_queue: str, workflows, activities):
-    worker = Worker(
-        client,
-        task_queue=task_queue,
-        workflows=workflows,
-        activities=activities,
-    )
-    await worker.run()
-
-
-async def run_activity(client: Client, name: str, func, param):
-    run_id = f"{name}_{uuid.uuid4().hex[:4]}"
-
-    try:
-        result = await client.execute_activity(
-            func,
-            param,
-            id=run_id,
-            task_queue="flock-queue",
-            start_to_close_timeout=300,  # e.g., 5 minutes
-        )
-        return result
-    except Exception:
-        raise

flock_core-0.5.0b28.dist-info/METADATA

@@ -1,274 +0,0 @@
-Metadata-Version: 2.4
-Name: flock-core
-Version: 0.5.0b28
-Summary: Declarative LLM Orchestration at Scale
-Author-email: Andre Ratzenberger <andre.ratzenberger@whiteduck.de>
-License-File: LICENSE
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.10
-Requires-Dist: aiosqlite>=0.21.0
-Requires-Dist: azure-data-tables>=12.7.0
-Requires-Dist: azure-storage-blob>=12.25.1
-Requires-Dist: chromadb>=0.6.3
-Requires-Dist: cloudpickle>=3.1.1
-Requires-Dist: croniter>=6.0.0
-Requires-Dist: datasets>=3.2.0
-Requires-Dist: devtools>=0.12.2
-Requires-Dist: dspy>=3.0.0
-Requires-Dist: fastapi>=0.115.8
-Requires-Dist: httpx>=0.28.1
-Requires-Dist: litellm>=1.75.3
-Requires-Dist: loguru>=0.7.3
-Requires-Dist: markdown2>=2.5.3
-Requires-Dist: mcp>=1.7.1
-Requires-Dist: msgpack>=1.1.0
-Requires-Dist: neo4j>=5.28.1
-Requires-Dist: openai==1.75.0
-Requires-Dist: opentelemetry-api>=1.30.0
-Requires-Dist: opentelemetry-exporter-jaeger-proto-grpc>=1.21.0
-Requires-Dist: opentelemetry-exporter-jaeger>=1.21.0
-Requires-Dist: opentelemetry-exporter-otlp>=1.30.0
-Requires-Dist: opentelemetry-instrumentation-logging>=0.51b0
-Requires-Dist: opentelemetry-sdk>=1.30.0
-Requires-Dist: opik>=1.7.26
-Requires-Dist: pandas>=2.2.3
-Requires-Dist: pillow>=10.4.0
-Requires-Dist: prometheus-client>=0.21.1
-Requires-Dist: psutil>=6.1.1
-Requires-Dist: pydantic-settings>=2.7.1
-Requires-Dist: pydantic>=2.10.5
-Requires-Dist: python-box>=7.3.2
-Requires-Dist: python-decouple>=3.8
-Requires-Dist: python-dotenv>=1.0.1
-Requires-Dist: pyyaml>=6.0
-Requires-Dist: questionary>=2.1.0
-Requires-Dist: rich>=13.7.0
-Requires-Dist: rouge-score>=0.1.2
-Requires-Dist: sentence-transformers>=3.4.1
-Requires-Dist: temporalio>=1.9.0
-Requires-Dist: thefuzz>=0.22.1
-Requires-Dist: tiktoken>=0.8.0
-Requires-Dist: toml>=0.10.2
-Requires-Dist: tqdm>=4.60.1
-Requires-Dist: uvicorn>=0.29.0
-Requires-Dist: wd-di>=0.2.14
-Requires-Dist: websockets>=13.0.1
-Requires-Dist: werkzeug>=3.1.3
-Requires-Dist: xlsxwriter>=3.2.3
-Provides-Extra: memory
-Requires-Dist: matplotlib>=3.10.0; extra == 'memory'
-Requires-Dist: mem0ai[graph]>=0.1.101; extra == 'memory'
-Requires-Dist: zep-python>=2.0.2; extra == 'memory'
-Description-Content-Type: text/markdown
-
-<p align="center">
-  <!-- Placeholder for your Flock Logo/Banner - Replace URL -->
-  <img alt="Flock Banner" src="https://raw.githubusercontent.com/whiteducksoftware/flock/master/docs/assets/images/flock.png" width="600">
-</p>
-<p align="center">
-  <!-- Update badges -->
-  <a href="https://pypi.org/project/flock-core/" target="_blank"><img alt="PyPI Version" src="https://img.shields.io/pypi/v/flock-core?style=for-the-badge&logo=pypi&label=pip%20version"></a>
-  <img alt="Python Version" src="https://img.shields.io/badge/python-3.10%2B-blue?style=for-the-badge&logo=python">
-  <a href="https://github.com/whiteducksoftware/flock/actions/workflows/deploy-whiteduck-pypi.yml" target="_blank"><img alt="CI Status" src="https://img.shields.io/github/actions/workflow/status/whiteducksoftware/flock/deploy-whiteduck-pypi.yml?branch=master&style=for-the-badge&logo=githubactions&logoColor=white"></a>
-  <a href="https://github.com/whiteducksoftware/flock/blob/master/LICENSE" target="_blank"><img alt="License" src="https://img.shields.io/pypi/l/flock-core?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://www.linkedin.com/company/whiteduck" target="_blank"><img alt="LinkedIn" src="https://img.shields.io/badge/linkedin-%230077B5.svg?style=for-the-badge&logo=linkedin&logoColor=white&label=whiteduck"></a>
-<a href="https://bsky.app/profile/whiteduck-gmbh.bsky.social" target="_blank"><img alt="Bluesky" src="https://img.shields.io/badge/bluesky-Follow-blue?style=for-the-badge&logo=bluesky&logoColor=%23fff&color=%23333&labelColor=%230285FF&label=whiteduck-gmbh"></a>
-</p>
-
-
----
-
-
-## The Problem You Know Too Well
-
-🤯 **Prompt Hell**: Brittle 500-line prompts that break with every model update.  
-💥 **System Failures**: One bad LLM response crashes your entire workflow  
-🧪 **Testing Nightmares**: "How do I unit test a prompt?" (You don't.)  
-🧪 **Measuring Quality**: "How do I know my prompts are close to optimal?" (You also don't.)  
-📄 **Output Chaos**: Parsing unstructured LLM responses into reliable data  
-⛓️ **Orchestration Limits**: Moving beyond simple chains and DAGs? Good luck  
-🚀 **Production Gap**: Jupyter notebooks don't scale to enterprise systems  
-
-*After building dozens of AI systems for enterprise clients, we realized the tooling was fundamentally broken.*
-
-
-**Build with agents, not against them.**
-
-
-## The Flock Solution
-
-**What if you could just skip that 'prompt engineering' step?**
-
-Flock is an agent framework for declarative AI workflows. You define what goes in and what should come out, the how is handled by the agent.   
-No brittle prompts. No guesswork. Just reliable, testable AI agents.
-
-
-✅ **Declarative Contracts**: Define inputs/outputs with Pydantic models. Flock handles the LLM complexity.  
-⚡ **Built-in Resilience**: Automatic retries, state persistence, and workflow resumption via Temporal.io  
-🧪 **Actually Testable**: Clear contracts make agents unit-testable like any other code  
-🧪 **Optimal Quality**: Agents posses multiple self-optimization algorithms based on latest research  
-🚀 **Dynamic Workflows**: Self-correcting loops, conditional routing, and intelligent decision-making  
-🔧 **Zero-Config Production**: Deploy as REST APIs with one command. Scale without rewriting.
-
-**Ready to see it in action?**
-
-## ⚡ Quick Start
-
-```python
-from flock.core import Flock, DefaultAgent
-
-# 1. Create the main orchestrator
-my_flock = Flock(model="openai/gpt-4.1")
-
-# 2. Declaratively define an agent
-brainstorm_agent = DefaultAgent(
-    name="idea_generator",
-    input="topic",
-    output="catchy_title, key_points",
-)
-
-# 3. Add the agent to the Flock
-my_flock.add_agent(brainstorm_agent)
-
-# 4. Run the agent!
-input_data = {"topic": "The future of AI agents"}
-result = my_flock.run(start_agent="idea_generator", input=input_data)
-
-# The result is a Box object (dot-accessible dict)
-print(f"Generated Title: {result.catchy_title}")
-print(f"Key Points: {result.key_points}")
-```
-
-**No 20-line prompt fiddling. Just structured output, every time.**
-
-![image](https://github.com/user-attachments/assets/37a897cb-910f-49fc-89d4-510a780ad775)
-
-**Explore more examples →** [**Flock Showcase Repository**](https://github.com/whiteducksoftware/flock-showcase)
-
-
-
-## 💾 Installation - Use Flock in your project
-
-Get started with the core Flock library:
-
-```bash
-# Using uv (recommended)
-uv pip install flock-core
-
-# Using pip
-pip install flock-core
-```
-
-Extras: Install optional dependencies for specific features:
-
-```bash
-# Flock tools and mcp server
-uv pip install flock-mcp
-```
-
-## 🔑 Installation - Develop Flock
-
-```bash
-git clone https://github.com/whiteducksoftware/flock.git
-cd flock
-
-# One-liner dev setup after cloning
-pip install poethepoet && poe install
-```
-
-Additional provided `poe` tasks and commands:
-
-```bash
-poe install # Install the project
-poe build # Build the project
-poe docs # Serve the docs
-poe format # Format the code
-poe lint # Lint the code
-```
-
-## 🔑 Environment Setup
-
-Flock uses environment variables (typically in a .env file) for configuration, especially API keys. Create a .env file in your project root:
-
-```bash
-# .env - Example
-
-# --- LLM Provider API Keys (Required by most examples) ---
-# Add keys for providers you use (OpenAI, Anthropic, Gemini, Azure, etc.)
-# Refer to litellm docs (https://docs.litellm.ai/docs/providers) for names
-OPENAI_API_KEY="your-openai-api-key"
-# ANTHROPIC_API_KEY="your-anthropic-api-key"
-
-# --- Tool-Specific Keys (Optional) ---
-# TAVILY_API_KEY="your-tavily-search-key"
-# GITHUB_PAT="your-github-personal-access-token"
-
-# --- Default Flock Settings (Optional) ---
-DEFAULT_MODEL="openai/gpt-4o" # Default LLM if agent doesn't specify
-
-# --- Flock CLI Settings (Managed by `flock settings`) ---
-# SHOW_SECRETS="False"
-# VARS_PER_PAGE="20"
-```
-
-Be sure that the .env file is added to your .gitignore!
-
-
-## 🐤 New in Flock 0.5.0 `Kea` 🐤
-
-Keas are one of the smartest birds in the world famous for figuring out multi-step puzzles, unlatching doors, and coordinating in small groups to get what it wants.
-
-<Insert Kea Logo>
-
-### Self-optimizing agents
-
-### Everything you need to evaluate and optimize agents
-
-### Benchmarks
-
-### Smooth Jupyter experience
-
-### Multi-Threading and Thread Safety
-
-
---------------------------------
-
-## 📚 Examples & Tutorials
-
-For a comprehensive set of examples, ranging from basic usage to complex projects and advanced features, please visit our dedicated showcase repository:
-
-➡️ [github.com/whiteducksoftware/flock-showcase](https://github.com/whiteducksoftware/flock-showcase) ⬅️
-
-The showcase includes:
-
-- Step-by-step guides for core concepts.
-- Examples of tool usage, routing, memory, and more.
-- Complete mini-projects demonstrating practical applications.
-
-## 📖 Documentation
-
-Full documentation, including API references and conceptual explanations, can be found at:
-
-➡️ [whiteducksoftware.github.io/flock/](https://whiteducksoftware.github.io/flock/) ⬅️
-
-## 🤝 Contributing
-
-We welcome contributions! Please see the CONTRIBUTING.md file (if available) or open an issue/pull request on GitHub.
-
-Ways to contribute:
-
-- Report bugs or suggest features.
-- Improve documentation.
-- Contribute new Modules, Evaluators, or Routers.
-- Add examples to the flock-showcase repository.
-
-## 📜 License
-
-Flock is licensed under the MIT License. See the LICENSE file for details.
-
-## 🏢 About
-
-Flock is developed and maintained by white duck GmbH, your partner for cloud-native solutions and AI integration.