flock-core 0.4.0b17__py3-none-any.whl → 0.4.0b19__py3-none-any.whl

flock_core-0.4.0b19.dist-info/METADATA

@@ -0,0 +1,280 @@
+Metadata-Version: 2.4
+Name: flock-core
+Version: 0.4.0b19
+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: azure-search-documents>=11.5.2
+Requires-Dist: chromadb>=0.6.3
+Requires-Dist: cloudpickle>=3.1.1
+Requires-Dist: datasets>=3.2.0
+Requires-Dist: devtools>=0.12.2
+Requires-Dist: dspy==2.6.16
+Requires-Dist: duckduckgo-search>=7.3.2
+Requires-Dist: fastapi>=0.115.8
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: litellm==1.63.7
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: matplotlib>=3.10.0
+Requires-Dist: msgpack>=1.1.0
+Requires-Dist: nltk>=3.9.1
+Requires-Dist: notion-client>=2.3.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: 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: python-fasthtml>=0.12.6
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: questionary>=2.1.0
+Requires-Dist: rich>=13.9.4
+Requires-Dist: sentence-transformers>=3.4.1
+Requires-Dist: temporalio>=1.9.0
+Requires-Dist: tiktoken>=0.8.0
+Requires-Dist: toml>=0.10.2
+Requires-Dist: tqdm>=4.67.1
+Requires-Dist: uvicorn>=0.34.0
+Requires-Dist: zep-python>=2.0.2
+Provides-Extra: all
+Requires-Dist: docling>=2.18.0; extra == 'all'
+Requires-Dist: markdownify>=0.14.1; extra == 'all'
+Requires-Dist: tavily-python>=0.5.0; extra == 'all'
+Provides-Extra: tools
+Requires-Dist: markdownify>=0.14.1; extra == 'tools'
+Requires-Dist: tavily-python>=0.5.0; extra == 'tools'
+Description-Content-Type: text/markdown
+
+# 🚀 Flock: The Declarative AI Agent Framework 🚀
+
+<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>
+
+🐤 Flock 0.4.0 currently in beta - use `pip install flock-core==0.4.0b5` 🐤
+
+🐤 `pip install flock-core` will install the latest non-beta version 🐤
+
+🐤  Expected Release for 0.4.0 `Magpie`: End of April 2025 🐤
+
+---
+
+**Tired of wrestling with paragraphs of prompt text just to get your AI agent to perform a specific, structured task?** 😫
+
+Enter **Flock**, the agent framework that lets you ditch the prompt-palaver and focus on **what** you want your agents to achieve through a **declarative approach**. Define your agent's inputs, outputs, and available tools using clear Python structures (including type hints!), and let Flock handle the complex LLM interactions and orchestration.
+
+Built with real-world deployment in mind, Flock integrates seamlessly with tools like **Temporal** (optional) for building robust, fault-tolerant, and scalable agent systems right out of the box.
+
+**Looking for examples and tutorials?** Check out the dedicated [**👉 flock-showcase Repository**](https://github.com/whiteducksoftware/flock-showcase)!
+
+## ✨ Why Join the Flock?
+
+Flock offers a different way to build agentic systems:
+
+| Traditional Agent Frameworks 😟        | Flock Framework 🐤🐧🐓🦆             |
+| :------------------------------------- | :------------------------------------ |
+| 🤯 **Prompt Nightmare**                | ✅ **Declarative Simplicity**         |
+| *Long, brittle, hard-to-tune prompts*  | *Clear input/output specs (typed!)*   |
+| 💥 **Fragile & Unpredictable**         | ⚡ **Robust & Production-Ready**     |
+| *Single errors can halt everything*    | *Fault-tolerant via Temporal option*  |
+| 🧩 **Monolithic & Rigid**             | 🔧 **Modular & Flexible**             |
+| *Hard to extend or modify logic*       | *Pluggable Evaluators, Modules, Tools*|
+| ⛓️ **Basic Chaining**                 | 🚀 **Advanced Orchestration**         |
+| *Often just linear workflows*          | *Dynamic Routing, Batch Processing*   |
+| 🧪 **Difficult Testing**               | ✅ **Testable Components**            |
+| *Hard to unit test prompt logic*       | *Clear I/O contracts aid testing*     |
+| 📄 **Unstructured Output**             | ✨ **Structured Data Handling**       |
+| *Parsing unreliable LLM text output*   | *Native Pydantic/Typed Dict support*  |
+
+## 💡 Core Concepts
+
+Flock's power comes from a few key ideas (Learn more in the [Full Documentation](https://whiteducksoftware.github.io/flock/)):
+
+1. **Declarative Agents:** Define agents by *what* they do (inputs/outputs), not *how*. Flock uses **Evaluators** (like the default `DeclarativeEvaluator` powered by DSPy) to handle the underlying logic.
+2. **Typed Signatures:** Specify agent inputs and outputs using Python type hints and optional descriptions (e.g., `"query: str | User request, context: Optional[List[MyType]]"`).
+3. **Modular Components:** Extend agent capabilities with pluggable **Modules** (e.g., for memory, metrics, output formatting) that hook into the agent's lifecycle.
+4. **Intelligent Workflows:** Chain agents explicitly or use **Routers** (LLM-based, Agent-based, or custom) for dynamic decision-making.
+5. **Reliable Execution:** Run locally for easy debugging or seamlessly switch to **Temporal** (optional) for production-grade fault tolerance, retries, and state management.
+6. **Tool Integration:** Equip agents with standard or custom Python functions (`@flock_tool`) registered via the `FlockRegistry`.
+7. **Registry:** A central place (`@flock_component`, `@flock_type`, `@flock_tool`) to register your custom classes, types, and functions, enabling robust serialization and dynamic loading.
+
+## 💾 Installation
+
+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
+# Common tools (Tavily, Markdownify)
+uv pip install flock-core[tools]
+
+# All optional dependencies (including tools, docling, etc.)
+uv pip install flock-core[all]
+```
+
+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"
+```
+
+Remember to add .env to your .gitignore!
+
+## ⚡ Quick Start Syntax
+
+While detailed examples and tutorials now live in the flock-showcase repository, here's a minimal example to illustrate the core syntax:
+
+```python
+from flock.core import Flock, FlockFactory
+
+# 1. Create the main orchestrator
+# Uses DEFAULT_MODEL from .env or defaults to "openai/gpt-4o" if not set
+my_flock = Flock(name="SimpleFlock")
+
+# 2. Declaratively define an agent using the Factory
+# Input: a topic (string)
+# Output: a title (string) and bullet points (list of strings)
+brainstorm_agent = FlockFactory.create_default_agent(
+    name="idea_generator",
+    description="Generates titles and key points for a given topic.",
+    input="topic: str | The subject to brainstorm about",
+    output="catchy_title: str, key_points: list[str] | 3-5 main bullet points"
+)
+
+# 3. Add the agent to the Flock
+my_flock.add_agent(brainstorm_agent)
+
+# 4. Run the agent!
+if __name__ == "__main__":
+    input_data = {"topic": "The future of AI agents"}
+    try:
+        # The result is a Box object (dot-accessible dict)
+        result = my_flock.run(start_agent="idea_generator", input=input_data)
+        print(f"Generated Title: {result.catchy_title}")
+        print("Key Points:")
+        for point in result.key_points:
+            print(f"- {point}")
+    except Exception as e:
+        print(f"An error occurred: {e}")
+        print("Ensure your LLM API key (e.g., OPENAI_API_KEY) is set in your .env file!")
+```
+
+## ✨ Utility: @flockclass Hydrator
+
+Flock also provides conveniences. The @flockclass decorator allows you to easily populate Pydantic models using an LLM:
+
+```python
+from pydantic import BaseModel
+from flock.util.hydrator import flockclass # Assuming hydrator utility exists
+import asyncio
+
+@flockclass(model="openai/gpt-4o") # Decorate your Pydantic model
+class CharacterIdea(BaseModel):
+    name: str
+    char_class: str
+    race: str
+    backstory_hook: str | None = None # Field to be filled by hydrate
+    personality_trait: str | None = None # Field to be filled by hydrate
+
+async def create_character():
+    # Create with minimal data
+    char = CharacterIdea(name="Gorok", char_class="Barbarian", race="Orc")
+    print(f"Before Hydration: {char}")
+
+    # Call hydrate to fill in the None fields using the LLM
+    hydrated_char = await char.hydrate()
+
+    print(f"\nAfter Hydration: {hydrated_char}")
+    print(f"Backstory Hook: {hydrated_char.backstory_hook}")
+
+# asyncio.run(create_character())
+```
+
+## 📚 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.
+- Join our Discord Community to discuss development! <!-- Add Discord link -->
+
+## 📜 License
+
+Flock is licensed under the Apache License 2.0. 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.

{flock_core-0.4.0b17.dist-info → flock_core-0.4.0b19.dist-info}/RECORD

@@ -12,7 +12,7 @@ flock/cli/load_release_notes.py,sha256=qFcgUrMddAE_TP6x1P-6ZywTUjTknfhTDW5LTxtg1
 flock/cli/loaded_flock_cli.py,sha256=IkeYvw52Bh3uFIm2O5xgppJ9KaY7jfh0VSFkiI46tTg,6855
 flock/cli/manage_agents.py,sha256=Psl014LCrJmBgwrjsp7O3WNlWvQmVd_IDud3rd0lnLI,12786
 flock/cli/registry_management.py,sha256=mAHy3wT97YgODR0gVOkTXDqR5NIPzM-E-z9dEtw9-tw,29790
-flock/cli/runner.py,sha256=TebsqwAfc_bTGzr-id6frgZXPCDJ5Xu1pBd9bZnqIDg,1120
+flock/cli/runner.py,sha256=TgiuhRLkpa6dn3C-3eCmWx-bWUlTjaH0sD7Y-O7MrYM,1122
 flock/cli/settings.py,sha256=Z_TXBzCYlCmSaKrJ_CQCdYy-Cj29gpI4kbC_2KzoKqg,27025
 flock/cli/view_results.py,sha256=dOzK0O1FHSIDERnx48y-2Xke9BkOHS7pcOhs64AyIg0,781
 flock/cli/yaml_editor.py,sha256=K3N0bh61G1TSDAZDnurqW9e_-hO6CtSQKXQqlDhCjVo,12527
@@ -44,7 +44,7 @@ flock/core/execution/local_executor.py,sha256=rnIQvaJOs6zZORUcR3vvyS6LPREDJTjayg
 flock/core/execution/temporal_executor.py,sha256=OF_uXgQsoUGp6U1ZkcuaidAEKyH7XDtbfrtdF10XQ_4,1675
 flock/core/interpreter/python_interpreter.py,sha256=RaUMZuufsKBNQ4FAeSaOgUuxzs8VYu5TgUUs-xwaxxM,26376
 flock/core/logging/__init__.py,sha256=Q8hp9-1ilPIUIV0jLgJ3_cP7COrea32cVwL7dicPnlM,82
-flock/core/logging/logging.py,sha256=-ViLNLTm5wqbvVsc6xYekOsAY38ZCIn6j1wciC7lgeM,15417
+flock/core/logging/logging.py,sha256=-Mzft9GOahe0cOQtNbdlh0yLH-00ZAl713xHugtRFeQ,15527
 flock/core/logging/telemetry.py,sha256=3E9Tyj6AUR6A5RlIufcdCdWm5BAA7tbOsCa7lHoUQaU,5404
 flock/core/logging/trace_and_logged.py,sha256=5vNrK1kxuPMoPJ0-QjQg-EDJL1oiEzvU6UNi6X8FiMs,2117
 flock/core/logging/formatters/enum_builder.py,sha256=LgEYXUv84wK5vwHflZ5h8HBGgvLH3sByvUQe8tZiyY0,981
@@ -63,7 +63,7 @@ flock/core/serialization/flock_serializer.py,sha256=TEePKaJqU-_XWHTMWyMHloDNwmkK
 flock/core/serialization/json_encoder.py,sha256=gAKj2zU_8wQiNvdkby2hksSA4fbPNwTjup_yz1Le1Vw,1229
 flock/core/serialization/secure_serializer.py,sha256=n5-zRvvXddgJv1FFHsaQ2wuYdL3WUSGPvG_LGaffEJo,6144
 flock/core/serialization/serializable.py,sha256=qlv8TsTqRuklXiNuCMrvro5VKz764xC2i3FlgLJSkdk,12129
-flock/core/serialization/serialization_utils.py,sha256=ONv7KUhc66e4sKYu9uFc3qU1jOg4DvIXRJ5QXaTIQj0,10298
+flock/core/serialization/serialization_utils.py,sha256=n5q6P18dEK1JHejgFhAv-87mODjKuz36GYV1n6p-VO4,12924
 flock/core/tools/azure_tools.py,sha256=hwLnI2gsEq6QzUoWj5eCGDKTdXY1XUf6K-H5Uwva2MY,17093
 flock/core/tools/basic_tools.py,sha256=Ye7nlI4RRkqWRy8nH9CKuItBmh_ZXxUpouGnCOfx0s0,9050
 flock/core/tools/llm_tools.py,sha256=Bdt4Dpur5dGpxd2KFEQyxjfZazvW1HCDKY6ydMj6UgQ,21811
@@ -72,7 +72,7 @@ flock/core/tools/zendesk_tools.py,sha256=deZAyUi9j-_yZaTayLQVJaFXIqIct-P6C8IGN5U
 flock/core/tools/dev_tools/github.py,sha256=a2OTPXS7kWOVA4zrZHynQDcsmEi4Pac5MfSjQOLePzA,5308
 flock/core/util/cli_helper.py,sha256=P3-lncS1J78MuPpDQ0D8qmfxMTCRxKkGdo9QRkzrp6A,49797
 flock/core/util/file_path_utils.py,sha256=Odf7uU32C-x1KNighbNERSiMtkzW4h8laABIoFK7A5M,6246
-flock/core/util/hydrator.py,sha256=6qNwOwCZB7r6y25BZ--0PGofrAlfMaXbDKFQeP5NLts,11196
+flock/core/util/hydrator.py,sha256=z0kvqr4j3piExOb_T5EgATuNm77ZlqIKvLpt4PJusO8,10949
 flock/core/util/input_resolver.py,sha256=g9vDPdY4OH-G7qjas5ksGEHueokHGFPMoLOvC-ngeLo,5984
 flock/core/util/loader.py,sha256=j3q2qem5bFMP2SmMuYjb-ISxsNGNZd1baQmpvAnRUUk,2244
 flock/evaluators/declarative/declarative_evaluator.py,sha256=j3xCEOhKHMvYtI43K2uqqJk068Lw94ch8GtWOmmJX7g,4803
@@ -86,7 +86,6 @@ flock/modules/callback/callback_module.py,sha256=volGGgHtY19qj1wHR6m5a_hmXSbV3Ca
 flock/modules/memory/memory_module.py,sha256=bSkdFBW-Pp5ldHhXi8v4kfRM7zknfLR2fsOtbTosucI,14916
 flock/modules/memory/memory_parser.py,sha256=FLH7GL8XThvHiCMfX3eQH7Sz-f62fzhAUmO6_gaDI7U,4372
 flock/modules/memory/memory_storage.py,sha256=CNcLDMmvv0x7Z3YMKr6VveS_VCa7rKPw8l2d-XgqokA,27246
-flock/modules/output/output_module.py,sha256=tpNqkL8cB0cvikr1fmEJ-5E2SAeb-rYhht8IP90mEF0,7281
 flock/modules/performance/metrics_module.py,sha256=UD9OjY4-zAvauMD7YyDYqE1gyIhzpdr3JkBT8j9knxY,16790
 flock/modules/zep/zep_module.py,sha256=x7JG6O6xnwwum0RETIqKYbA3xzdcvX2aUuns0Cl0c2Q,6014
 flock/platform/docker_tools.py,sha256=fpA7-6rJBjPOUBLdQP4ny2QPgJ_042nmqRn5GtKnoYw,1445
@@ -440,8 +439,8 @@ flock/workflow/activities.py,sha256=eVZDnxGJl_quNO-UTV3YgvTV8LrRaHN3QDAA1ANKzac,
 flock/workflow/agent_activities.py,sha256=NhBZscflEf2IMfSRa_pBM_TRP7uVEF_O0ROvWZ33eDc,963
 flock/workflow/temporal_setup.py,sha256=VWBgmBgfTBjwM5ruS_dVpA5AVxx6EZ7oFPGw4j3m0l0,1091
 flock/workflow/workflow.py,sha256=I9MryXW_bqYVTHx-nl2epbTqeRy27CAWHHA7ZZA0nAk,1696
-flock_core-0.4.0b17.dist-info/METADATA,sha256=E4VmDMbJkqZ3CQCVQy3KFnWGYIW6xfLfHX-wKKZpbDU,21101
-flock_core-0.4.0b17.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-flock_core-0.4.0b17.dist-info/entry_points.txt,sha256=rWaS5KSpkTmWySURGFZk6PhbJ87TmvcFQDi2uzjlagQ,37
-flock_core-0.4.0b17.dist-info/licenses/LICENSE,sha256=iYEqWy0wjULzM9GAERaybP4LBiPeu7Z1NEliLUdJKSc,1072
-flock_core-0.4.0b17.dist-info/RECORD,,
+flock_core-0.4.0b19.dist-info/METADATA,sha256=AxxdPGiZnMvkFqmHKNmVLN4FH07NWjUSPXHGhamhF54,12697
+flock_core-0.4.0b19.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+flock_core-0.4.0b19.dist-info/entry_points.txt,sha256=rWaS5KSpkTmWySURGFZk6PhbJ87TmvcFQDi2uzjlagQ,37
+flock_core-0.4.0b19.dist-info/licenses/LICENSE,sha256=iYEqWy0wjULzM9GAERaybP4LBiPeu7Z1NEliLUdJKSc,1072
+flock_core-0.4.0b19.dist-info/RECORD,,

flock/modules/output/output_module.py

@@ -1,194 +0,0 @@
-"""Output formatting and display functionality for agents."""
-
-from typing import TYPE_CHECKING, Any
-
-from pydantic import Field
-
-from flock.core.context.context_vars import FLOCK_BATCH_SILENT_MODE
-
-if TYPE_CHECKING:
-    from flock.core import FlockAgent
-
-from flock.core.context.context import FlockContext
-from flock.core.flock_module import FlockModule, FlockModuleConfig
-from flock.core.logging.formatters.themed_formatter import (
-    ThemedAgentResultFormatter,
-)
-from flock.core.logging.formatters.themes import OutputTheme
-from flock.core.logging.logging import get_logger
-
-# from flock.core.logging.formatters.themes import OutputTheme
-# from flock.core.logging.logging import get_logger
-# from flock.core.serialization.json_encoder import FlockJSONEncoder
-
-logger = get_logger("module.output")
-
-
-class OutputModuleConfig(FlockModuleConfig):
-    """Configuration for output formatting and display."""
-
-    theme: OutputTheme = Field(
-        default=OutputTheme.afterglow, description="Theme for output formatting"
-    )
-    render_table: bool = Field(
-        default=False, description="Whether to render output as a table"
-    )
-    max_length: int = Field(
-        default=1000, description="Maximum length for displayed output"
-    )
-    truncate_long_values: bool = Field(
-        default=True, description="Whether to truncate long values in display"
-    )
-    show_metadata: bool = Field(
-        default=True, description="Whether to show metadata like timestamps"
-    )
-    format_code_blocks: bool = Field(
-        default=True,
-        description="Whether to apply syntax highlighting to code blocks",
-    )
-    custom_formatters: dict[str, str] = Field(
-        default_factory=dict,
-        description="Custom formatters for specific output types",
-    )
-    no_output: bool = Field(
-        default=False,
-        description="Whether to suppress output",
-    )
-    print_context: bool = Field(
-        default=False,
-        description="Whether to print the context",
-    )
-
-
-class OutputModule(FlockModule):
-    """Module that handles output formatting and display."""
-
-    name: str = "output"
-    config: OutputModuleConfig = Field(
-        default_factory=OutputModuleConfig, description="Output configuration"
-    )
-
-    def __init__(self, name: str, config: OutputModuleConfig):
-        super().__init__(name=name, config=config)
-        self._formatter = ThemedAgentResultFormatter(
-            theme=self.config.theme,
-            max_length=self.config.max_length,
-            render_table=self.config.render_table,
-        )
-
-    def _format_value(self, value: Any, key: str) -> str:
-        """Format a single value based on its type and configuration."""
-        # Check for custom formatter
-        if key in self.config.custom_formatters:
-            formatter_name = self.config.custom_formatters[key]
-            if hasattr(self, f"_format_{formatter_name}"):
-                return getattr(self, f"_format_{formatter_name}")(value)
-
-        # Default formatting based on type
-        if isinstance(value, dict):
-            return self._format_dict(value)
-        elif isinstance(value, list):
-            return self._format_list(value)
-        elif isinstance(value, str) and self.config.format_code_blocks:
-            return self._format_potential_code(value)
-        else:
-            return str(value)
-
-    def _format_dict(self, d: dict[str, Any], indent: int = 0) -> str:
-        """Format a dictionary with proper indentation."""
-        lines = []
-        for k, v in d.items():
-            formatted_value = self._format_value(v, k)
-            if (
-                self.config.truncate_long_values
-                and len(formatted_value) > self.config.max_length
-            ):
-                formatted_value = (
-                    formatted_value[: self.config.max_length] + "..."
-                )
-            lines.append(f"{'  ' * indent}{k}: {formatted_value}")
-        return "\n".join(lines)
-
-    def _format_list(self, lst: list[Any]) -> str:
-        """Format a list with proper indentation."""
-        return "\n".join(f"- {self._format_value(item, '')}" for item in lst)
-
-    def _format_potential_code(self, text: str) -> str:
-        """Format text that might contain code blocks."""
-        import re
-
-        def replace_code_block(match):
-            code = match.group(2)
-            lang = match.group(1) if match.group(1) else ""
-            # Here you could add syntax highlighting
-            return f"```{lang}\n{code}\n```"
-
-        # Replace code blocks with formatted versions
-        text = re.sub(
-            r"```(\w+)?\n(.*?)\n```", replace_code_block, text, flags=re.DOTALL
-        )
-        return text
-
-    async def post_evaluate(
-        self,
-        agent: "FlockAgent",
-        inputs: dict[str, Any],
-        result: dict[str, Any],
-        context: FlockContext | None = None,
-    ) -> dict[str, Any]:
-        """Format and display the output."""
-        logger.debug("Formatting and displaying output")
-
-        # Determine if output should be suppressed
-        is_silent = self.config.no_output or (
-            context and context.get_variable(FLOCK_BATCH_SILENT_MODE, False)
-        )
-
-        if is_silent:
-            logger.debug("Output suppressed (config or batch silent mode).")
-            return result  # Skip console output
-
-        logger.debug("Formatting and displaying output to console.")
-
-        if self.config.print_context and context:
-            # Add context snapshot if requested (be careful with large contexts)
-            try:
-                # Create a copy or select relevant parts to avoid modifying original result dict directly
-                display_result = result.copy()
-                display_result["context_snapshot"] = (
-                    context.to_dict()
-                )  # Potential performance hit
-            except Exception:
-                display_result = result.copy()
-                display_result["context_snapshot"] = (
-                    "[Error serializing context]"
-                )
-            result_to_display = display_result
-        else:
-            result_to_display = result
-
-        if not hasattr(self, "_formatter") or self._formatter is None:
-            self._formatter = ThemedAgentResultFormatter(
-                theme=self.config.theme,
-                max_length=self.config.max_length,
-                render_table=self.config.render_table,
-                wait_for_input=self.config.wait_for_input,
-            )
-        self._formatter.display_result(result_to_display, agent.name)
-
-        return result  # Return the original, unmodified result
-
-    def update_theme(self, new_theme: OutputTheme) -> None:
-        """Update the output theme."""
-        self.config.theme = new_theme
-        self._formatter = ThemedAgentResultFormatter(
-            theme=self.config.theme,
-            max_length=self.config.max_length,
-            render_table=self.config.render_table,
-            wait_for_input=self.config.wait_for_input,
-            write_to_file=self.config.write_to_file,
-        )
-
-    def add_custom_formatter(self, key: str, formatter_name: str) -> None:
-        """Add a custom formatter for a specific output key."""
-        self.config.custom_formatters[key] = formatter_name