flock-core 0.3.36__tar.gz → 0.3.38__tar.gz

{flock_core-0.3.36 → flock_core-0.3.38}/.project/SPECS.md

@@ -55,10 +55,40 @@ Flock is a declarative agent framework that focuses on simplifying the creation
 
 9. [**CLI System**](specs/09_cli_system.md)
    - Defines the command-line interface architecture
-   - Specifies modules like the Settings Editor and Theme Builder
+   - Specifies modules like the Settings Editor
    - Documents environment profile management
    - Outlines UI components and navigation patterns
 
+10. [**Workflow System**](specs/10_workflow_system.md)
+    - Defines Temporal workflow integration
+    - Specifies activity implementation for agent chains
+    - Documents workflow execution flow
+    - Outlines tracing and observability features
+
+11. [**Memory System**](specs/11_memory_system.md)
+    - Defines agent memory capabilities
+    - Specifies storage and retrieval mechanisms
+    - Documents concept extraction and memory operations
+    - Outlines memory integration with agent lifecycle
+
+12. [**Platform System**](specs/12_platform_system.md)
+    - Defines infrastructure management utilities
+    - Specifies Docker and Jaeger integration
+    - Documents observability infrastructure setup
+    - Outlines containerization support
+
+13. [**Registry System**](specs/13_registry_system.md)
+    - Defines centralized component management
+    - Specifies registration of agents, callables, types, and components
+    - Documents decorator system for easy registration
+    - Outlines dynamic import capabilities
+
+14. [**Serialization System**](specs/14_serialization_system.md)
+    - Defines conversion of components to various formats
+    - Specifies serialization interfaces and utilities
+    - Documents support for multiple serialization formats
+    - Outlines secure serialization capabilities
+
 ## Design Principles
 
 These specifications reveal several core design principles that guided the development of Flock:
@@ -69,6 +99,8 @@ These specifications reveal several core design principles that guided the devel
 4. **Production Readiness** - Support for distributed execution, observability, and error handling
 5. **Developer Experience** - Simplified API with sensible defaults and clear patterns
 6. **User-Friendly Interface** - Intuitive CLI with clear navigation and helpful feedback
+7. **Centralized Registry** - Single source of truth for component registration and lookup
+8. **Serialization Support** - Comprehensive support for storing and sharing components
 
 ## Implementation Status
 
@@ -83,4 +115,6 @@ Based on the specifications, potential future enhancements could include:
 3. Additional module types for common agent patterns
 4. Expanded router capabilities for complex workflows
 5. Integration with additional execution engines beyond Temporal
-6. Extended CLI functionality for agent management and monitoring 
+6. Extended CLI functionality for agent management and monitoring
+7. Advanced memory capabilities for improved agent reasoning
+8. Enhanced serialization for cross-platform compatibility 

{flock_core-0.3.36 → flock_core-0.3.38}/PKG-INFO

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

{flock_core-0.3.36 → flock_core-0.3.38}/pyproject.toml

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

{flock_core-0.3.36 → flock_core-0.3.38}/src/flock/core/flock.py

@@ -9,6 +9,7 @@ import uuid
 from pathlib import Path
 from typing import TYPE_CHECKING, Any, TypeVar
 
+from box import Box
 from opentelemetry import trace
 from opentelemetry.baggage import get_baggage, set_baggage
 
@@ -73,7 +74,7 @@ class Flock(BaseModel, Serializable):
     It is serializable to various formats like YAML and JSON.
     """
 
-    name: str = Field(
+    name: str | None = Field(
         default_factory=lambda: f"flock_{uuid.uuid4().hex[:8]}",
         description="A unique identifier for this Flock instance.",
     )
@@ -111,6 +112,7 @@ class Flock(BaseModel, Serializable):
         name: str | None = None,
         model: str | None = "openai/gpt-4o",
         description: str | None = None,
+        show_flock_banner: bool = True,
         enable_temporal: bool = False,
         enable_logging: bool
         | list[str] = False,  # Keep logging control at init
@@ -120,6 +122,7 @@ class Flock(BaseModel, Serializable):
         """Initialize the Flock orchestrator."""
         # Initialize Pydantic fields
         super().__init__(
+            name=name,
             model=model,
             description=description,
             enable_temporal=enable_temporal,
@@ -149,7 +152,8 @@ class Flock(BaseModel, Serializable):
                     )
 
         # Initialize console if needed
-        init_console()
+        if show_flock_banner:
+            init_console()
 
         # Set Temporal debug environment variable
         self._set_temporal_debug_flag()
@@ -167,7 +171,7 @@ class Flock(BaseModel, Serializable):
     # ... (implementation as before) ...
     def _configure_logging(self, enable_logging: bool | list[str]):
         """Configure logging levels based on the enable_logging flag."""
-        logger.debug(f"Configuring logging, enable_logging={enable_logging}")
+        # logger.debug(f"Configuring logging, enable_logging={enable_logging}")
         is_enabled_globally = False
         enabled_loggers = []
 
@@ -264,9 +268,9 @@ class Flock(BaseModel, Serializable):
         context: FlockContext
         | None = None,  # Allow passing initial context state
         run_id: str = "",
-        box_result: bool = False,  # Changed default to False for raw dict
+        box_result: bool = True,  # Changed default to False for raw dict
         agents: list[FlockAgent] | None = None,  # Allow adding agents via run
-    ) -> dict:
+    ) -> Box:
         """Entry point for running an agent system synchronously."""
         return asyncio.run(
             self.run_async(
@@ -285,9 +289,9 @@ class Flock(BaseModel, Serializable):
         input: dict | None = None,
         context: FlockContext | None = None,
         run_id: str = "",
-        box_result: bool = False,  # Changed default
+        box_result: bool = True,  # Changed default
         agents: list[FlockAgent] | None = None,  # Allow adding agents via run
-    ) -> dict:
+    ) -> Box:
         """Entry point for running an agent system asynchronously."""
         # This import needs to be here or handled carefully due to potential cycles
         from flock.core.flock_agent import FlockAgent as ConcreteFlockAgent

{flock_core-0.3.36 → flock_core-0.3.38}/src/flock/core/flock_registry.py

@@ -66,7 +66,7 @@ class FlockRegistry:
         if cls._instance is None:
             cls._instance = super().__new__(cls)
             cls._instance._initialize()
-            logger.info("FlockRegistry instance created.")
+            # logger.info("FlockRegistry instance created.")
         return cls._instance
 
     def _initialize(self):
@@ -75,7 +75,7 @@ class FlockRegistry:
         self._callables = {}
         self._types = {}
         self._components = {}
-        logger.debug("FlockRegistry initialized internal stores.")
+        # logger.debug("FlockRegistry initialized internal stores.")
         # Auto-register core Python types
         self._register_core_types()
 
@@ -227,7 +227,7 @@ class FlockRegistry:
                     f"Type '{type_name}' already registered. Overwriting."
                 )
             self._types[type_name] = type_obj
-            logger.debug(f"Registered type: {type_name}")
+            # logger.debug(f"Registered type: {type_name}")
             return type_name
         return None
 
@@ -529,4 +529,4 @@ def _auto_register_by_path():
 
 
 # Bootstrapping the registry
-_auto_register_by_path()
+# _auto_register_by_path()

{flock_core-0.3.36 → flock_core-0.3.38}/uv.lock

@@ -1245,7 +1245,7 @@ wheels = [
 
 [[package]]
 name = "flock-core"
-version = "0.3.36"
+version = "0.3.38"
 source = { editable = "." }
 dependencies = [
     { name = "azure-search-documents" },

flock_core-0.3.36/bloggy.flock.yaml

@@ -1,50 +0,0 @@
-model: openai/gpt-4o
-enable_temporal: false
-agents:
-  bloggy:
-    name: bloggy
-    model: openai/gpt-4o
-    input: blog_idea
-    output: funny_blog_title, blog_headers
-    use_cache: true
-    evaluator:
-      name: default
-      config:
-        model: openai/gpt-4o
-        use_cache: true
-        temperature: 0.0
-        max_tokens: 4096
-      type: DeclarativeEvaluator
-    modules:
-      output:
-        name: output
-        config:
-          enabled: true
-          theme: abernathy
-          render_table: false
-          max_length: 1000
-          wait_for_input: false
-          write_to_file: false
-          output_dir: output/
-          truncate_long_values: true
-          show_metadata: true
-          format_code_blocks: true
-          custom_formatters: {}
-          no_output: false
-          print_context: false
-        type: OutputModule
-      metrics:
-        name: metrics
-        config:
-          enabled: true
-          collect_timing: true
-          collect_memory: true
-          collect_token_usage: true
-          collect_cpu: true
-          storage_type: json
-          metrics_dir: metrics/
-          aggregation_interval: 1h
-          retention_days: 30
-          alert_on_high_latency: true
-          latency_threshold_ms: 30000
-        type: MetricsModule

flock_core-0.3.36/my_flock.flock.yaml

@@ -1,52 +0,0 @@
-model: openai/gpt-4o
-description: a blog flock
-enable_temporal: false
-agents:
-  my_agent:
-    name: my_agent
-    model: openai/gpt-4o
-    description: An agent creating software ideas
-    input: idea
-    output: 'software_title, software_epics: list, software_implementation_plan'
-    use_cache: true
-    evaluator:
-      name: default
-      config:
-        model: openai/gpt-4o
-        use_cache: true
-        temperature: 0.0
-        max_tokens: 4096
-      type: DeclarativeEvaluator
-    modules:
-      output:
-        name: output
-        config:
-          enabled: true
-          theme: abernathy
-          render_table: true
-          max_length: 1000
-          wait_for_input: false
-          write_to_file: false
-          output_dir: output/
-          truncate_long_values: true
-          show_metadata: true
-          format_code_blocks: true
-          custom_formatters: {}
-          no_output: false
-          print_context: false
-        type: OutputModule
-      metrics:
-        name: metrics
-        config:
-          enabled: true
-          collect_timing: true
-          collect_memory: true
-          collect_token_usage: true
-          collect_cpu: true
-          storage_type: json
-          metrics_dir: metrics/
-          aggregation_interval: 1h
-          retention_days: 30
-          alert_on_high_latency: true
-          latency_threshold_ms: 30000
-        type: MetricsModule

flock_core-0.3.36/project.flock.yaml

@@ -1,104 +0,0 @@
-model: openai/gpt-4o
-enable_temporal: false
-agents:
-  idea_agent:
-    name: idea_agent
-    model: openai/gpt-4o
-    description: ''
-    input: query
-    output: a_fun_software_project_idea
-    use_cache: true
-    evaluator:
-      name: default
-      config:
-        model: openai/gpt-4o
-        use_cache: true
-        temperature: 0.0
-        max_tokens: 4096
-      type: DeclarativeEvaluator
-    handoff_router:
-      name: default_router
-      config:
-        enabled: true
-        hand_off: project_plan_agent
-      type: DefaultRouter
-    modules:
-      output:
-        name: output
-        config:
-          enabled: true
-          theme: abernathy
-          render_table: true
-          max_length: 1000
-          wait_for_input: true
-          write_to_file: false
-          output_dir: output/
-          truncate_long_values: true
-          show_metadata: true
-          format_code_blocks: true
-          custom_formatters: {}
-          no_output: false
-          print_context: false
-        type: OutputModule
-      metrics:
-        name: metrics
-        config:
-          enabled: true
-          collect_timing: true
-          collect_memory: true
-          collect_token_usage: true
-          collect_cpu: true
-          storage_type: json
-          metrics_dir: metrics/
-          aggregation_interval: 1h
-          retention_days: 30
-          alert_on_high_latency: true
-          latency_threshold_ms: 30000
-        type: MetricsModule
-  project_plan_agent:
-    name: project_plan_agent
-    model: openai/gpt-4o
-    input: a_fun_software_project_idea
-    output: catchy_project_name, project_pitch, techstack, project_implementation_plan
-    use_cache: true
-    evaluator:
-      name: default
-      config:
-        model: openai/gpt-4o
-        use_cache: true
-        temperature: 0.0
-        max_tokens: 4096
-      type: DeclarativeEvaluator
-    modules:
-      output:
-        name: output
-        config:
-          enabled: true
-          theme: abernathy
-          render_table: true
-          max_length: 1000
-          wait_for_input: true
-          write_to_file: false
-          output_dir: output/
-          truncate_long_values: true
-          show_metadata: true
-          format_code_blocks: true
-          custom_formatters: {}
-          no_output: false
-          print_context: false
-        type: OutputModule
-      metrics:
-        name: metrics
-        config:
-          enabled: true
-          collect_timing: true
-          collect_memory: true
-          collect_token_usage: true
-          collect_cpu: true
-          storage_type: json
-          metrics_dir: metrics/
-          aggregation_interval: 1h
-          retention_days: 30
-          alert_on_high_latency: true
-          latency_threshold_ms: 30000
-        type: MetricsModule

flock_core-0.3.36/test.yaml

@@ -1,18 +0,0 @@
-string_val: test
-int_val: 42
-float_val: 3.14
-bool_val: true
-list_val:
-- a
-- b
-- c
-dict_val:
-  key1: value1
-  key2: value2
-nested_val:
-  nested1:
-    key: value
-  nested2:
-  - 1
-  - 2
-  - 3