flock-core 0.5.0b60__tar.gz → 0.5.0b61__tar.gz

{flock_core-0.5.0b60 → flock_core-0.5.0b61}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flock-core
-Version: 0.5.0b60
+Version: 0.5.0b61
 Summary: Add your description here
 Author-email: Andre Ratzenberger <andre.ratzenberger@whiteduck.de>
 License-File: LICENSE

{flock_core-0.5.0b60 → flock_core-0.5.0b61}/docs/examples/index.md

@@ -306,8 +306,8 @@ Have you built something cool with Flock? Share it!
 ## Related Documentation
 
 - **[Getting Started](../getting-started/index.md)** - Installation and quick start
-- **[User Guides](../guides/)** - Comprehensive guides
-- **[API Reference](../reference/)** - Complete API docs
+- **[User Guides](../guides/index.md)** - Comprehensive guides
+- **[API Reference](../reference/index.md)** - Complete API docs
 
 ---
 

{flock_core-0.5.0b60 → flock_core-0.5.0b61}/docs/getting-started/index.md

@@ -49,7 +49,7 @@ New to Flock? Follow this recommended learning path:
 3. **[Core Concepts](concepts.md)** (15 minutes)
    Understand how Flock's blackboard architecture works
 
-4. **[User Guides](../guides/)** (ongoing)
+4. **[User Guides](../guides/index.md)** (ongoing)
    Dive deep into agents, blackboard patterns, and advanced features
 
 ---
@@ -107,7 +107,7 @@ Agents automatically execute when their input types appear on the blackboard. No
 
     Monitor and debug with OpenTelemetry and DuckDB.
 
-    [:octicons-arrow-right-24: Tracing Guide](../guides/tracing/)
+    [:octicons-arrow-right-24: Tracing Guide](../guides/tracing/tracing-quickstart.md)
 
 </div>
 

{flock_core-0.5.0b60 → flock_core-0.5.0b61}/docs/guides/index.md

@@ -184,4 +184,4 @@ Can't find what you're looking for?
 
 ---
 
-**Start with the basics** → [Getting Started](../getting-started/){ .md-button .md-button--primary }
+**Start with the basics** → [Getting Started](../getting-started/index.md){ .md-button .md-button--primary }

{flock_core-0.5.0b60 → flock_core-0.5.0b61}/docs/reference/index.md

@@ -317,8 +317,8 @@ See [Changelog](https://github.com/whiteducksoftware/flock/releases) for complet
 
 ## Related Documentation
 
-- **[Getting Started](../getting-started/)** - Installation and quick start
-- **[User Guides](../guides/)** - Comprehensive guides
+- **[Getting Started](../getting-started/index.md)** - Installation and quick start
+- **[User Guides](../guides/index.md)** - Comprehensive guides
 - **[Examples](https://github.com/whiteducksoftware/flock/tree/main/examples)** - Working code examples
 
 ---

{flock_core-0.5.0b60 → flock_core-0.5.0b61}/docs/stylesheets/extra.css

@@ -69,6 +69,76 @@
   min-height: 2.8rem !important;
 }
 
+.md-tabs {
+  background: var(--flock-primary-600) !important;
+  align-items: baseline !important;
+}
+
+.md-tabs__list {
+  white-space: nowrap !important;
+  padding: 0 !important;
+  contain: none !important;
+  width: auto !important;
+  min-width: 100% !important;
+  display: flex !important;
+  align-items: center !important;
+  margin: 0 !important;
+}
+
+.md-tabs__item {
+  display: flex !important;
+  flex: 0 0 auto !important;
+  min-width: auto !important;
+  align-items: center !important;
+}
+
+.md-tabs__link {
+  transition: all var(--flock-transition-base);
+  position: relative;
+  font-weight: 600;
+  font-size: 0.75rem;
+  padding: 0.1rem 0.8rem !important;
+  margin-bottom: 5px;
+  border-radius: 8px 8px 0 0;
+  white-space: nowrap !important;
+  overflow: visible !important;
+  text-overflow: clip !important;
+  max-width: none !important;
+  width: auto !important;
+  display: flex !important;
+  align-items: center !important;
+  flex: 20 20 auto !important;
+  min-width: fit-content !important;
+}
+
+.md-tabs__link:hover {
+  background: var(--flock-primary-400);
+  transform: translateY(-2px);
+}
+
+.md-tabs__link::after {
+  content: '';
+  position: absolute;
+  bottom: 0;
+  left: 0;
+  right: 0;
+  height: 3px;
+  background: var(--flock-primary-400);
+  transform: scaleX(0);
+  transition: transform var(--flock-transition-base);
+  border-radius: 2px 2px 0 0;
+  box-shadow: 0 0 15px rgba(6, 182, 212, 0.5);
+}
+
+.md-tabs__link:hover::after,
+.md-tabs__link--active::after {
+  transform: scaleX(1);
+}
+
+.md-tabs__link--active {
+  background: rgba(255, 255, 255, 0.05);
+}
+
 /* Hide the logo/emoji completely */
 .md-header__button.md-logo,
 .md-logo {
@@ -100,6 +170,25 @@
   display: none !important;
 }
 
+/* Sidebar navigation improvements */
+/* .md-nav__link {
+  transition: all var(--flock-transition-fast);
+  border-radius: 6px;
+  margin: 2px 0;
+} */
+
+.md-nav__link:hover {
+  transform: translateX(4px);
+  background: linear-gradient(90deg, transparent, rgba(79, 70, 229, 0.1));
+}
+
+.md-nav__link--active {
+  font-weight: 600;
+  background: linear-gradient(90deg, rgba(79, 70, 229, 0.1), transparent);
+  border-left: 3px solid var(--flock-accent);
+  padding-left: calc(0.6rem + 3px);
+}
+
 .md-header__title .md-header__ellipsis::before {
   content: 'Flock';
   display: inline-block;
@@ -137,29 +226,78 @@
 }
 
 /* ============================================
-   SMOOTH SCROLLING & PERFORMANCE
+   READING PROGRESS BAR
    ============================================ */
 
-html {
-  scroll-behavior: smooth;
-  scroll-padding-top: 4rem; /* Account for fixed header */
+.reading-progress-bar {
+  position: fixed;
+  top: 0;
+  left: 0;
+  width: 0%;
+  height: 3px;
+  background: linear-gradient(90deg, var(--flock-gradient-start), var(--flock-gradient-end));
+  z-index: 1000;
+  transition: width var(--flock-transition-fast);
+  box-shadow: 0 2px 4px rgba(0, 0, 0, 0.2);
 }
 
-/* Optimize animations for performance */
-@media (prefers-reduced-motion: no-preference) {
-  * {
-    scroll-behavior: smooth;
-  }
+/* ============================================
+   IMPROVED SEARCH
+   ============================================ */
+
+.md-search__form {
+  border-radius: 24px;
+  transition: box-shadow var(--flock-transition-base);
 }
 
-@media (prefers-reduced-motion: reduce) {
-  *,
-  *::before,
-  *::after {
-    animation-duration: 0.01ms !important;
-    animation-iteration-count: 1 !important;
-    transition-duration: 0.01ms !important;
-  }
+.md-search__form:hover,
+.md-search__form:focus-within {
+  box-shadow: var(--flock-shadow-md);
+}
+
+.md-search__input {
+  border-radius: 24px;
+}
+
+
+/* ============================================
+   IMPROVED HEADINGS
+   ============================================ */
+
+.md-typeset h1,
+.md-typeset h2 {
+  font-weight: 700;
+  letter-spacing: -0.025em;
+}
+
+.md-typeset h1 {
+  background: linear-gradient(135deg, var(--flock-gradient-start), var(--flock-gradient-end));
+  -webkit-background-clip: text;
+  -webkit-text-fill-color: transparent;
+  background-clip: text;
+}
+
+.md-typeset h2 {
+  border-bottom: 2px solid;
+  border-image: linear-gradient(90deg, var(--flock-gradient-start), transparent) 1;
+  padding-bottom: 0.5rem;
+}
+
+/* Permalink hover effect */
+.md-typeset .headerlink {
+  opacity: 0;
+  transition: opacity var(--flock-transition-fast), transform var(--flock-transition-fast);
+  transform: translateX(-4px);
+}
+
+.md-typeset :hover > .headerlink {
+  opacity: 0.5;
+  transform: translateX(0);
+}
+
+.md-typeset .headerlink:hover {
+  opacity: 1 !important;
+  transform: scale(1.2);
 }
 
 /* ============================================
@@ -194,21 +332,6 @@ html {
   scrollbar-color: var(--flock-gradient-start) transparent;
 }
 
-/* ============================================
-   READING PROGRESS BAR
-   ============================================ */
-
-.reading-progress-bar {
-  position: fixed;
-  top: 0;
-  left: 0;
-  width: 0%;
-  height: 3px;
-  background: linear-gradient(90deg, var(--flock-gradient-start), var(--flock-gradient-end));
-  z-index: 1000;
-  transition: width var(--flock-transition-fast);
-  box-shadow: 0 2px 4px rgba(0, 0, 0, 0.2);
-}
 
 /* ============================================
    ENHANCED CODE BLOCKS
@@ -252,6 +375,7 @@ code:not(.highlight code) {
   transform: scale(0.95);
 }
 
+
 /* ============================================
    ENHANCED TABLES
    ============================================ */
@@ -268,13 +392,13 @@ code:not(.highlight code) {
 }
 
 .md-typeset table:not([class]) th {
-  background: linear-gradient(135deg, var(--flock-gradient-start), var(--flock-gradient-end));
+  background: var(--flock-primary-400);
   color: white;
   font-weight: 600;
   text-transform: uppercase;
   font-size: 0.75rem;
   letter-spacing: 0.05em;
-  padding: 1rem;
+  padding: 0.5rem;
 }
 
 .md-typeset table:not([class]) tr {
@@ -285,6 +409,7 @@ code:not(.highlight code) {
   background-color: rgba(79, 70, 229, 0.05);
 }
 
+
 /* ============================================
    IMPROVED ADMONITIONS
    ============================================ */
@@ -306,234 +431,7 @@ code:not(.highlight code) {
   letter-spacing: 0.025em;
 }
 
-/* ============================================
-   ENHANCED NAVIGATION
-   ============================================ */
-
-/* Hide the "Home" text in the left sidebar that covers content */
-.md-nav--primary .md-nav__item--active > .md-nav__link {
-  display: none !important;
-}
-
-/* Also hide by href and title containing Home emoji */
-.md-nav--primary .md-nav__link[href="/"],
-.md-nav--primary .md-nav__link[href="./"],
-.md-nav__link[title="🏠 Home"],
-.md-nav__link[title="Home"] {
-  display: none !important;
-}
-
-/* Adjust spacing when "Home" is hidden */
-.md-nav--primary > .md-nav__list > .md-nav__item > .md-nav {
-  margin-top: 0;
-}
 
-/* Sidebar navigation improvements */
-.md-nav__link {
-  transition: all var(--flock-transition-fast);
-  border-radius: 6px;
-  margin: 2px 0;
-}
-
-.md-nav__link:hover {
-  transform: translateX(4px);
-  background: linear-gradient(90deg, transparent, rgba(79, 70, 229, 0.1));
-}
-
-.md-nav__link--active {
-  font-weight: 600;
-  background: linear-gradient(90deg, rgba(79, 70, 229, 0.1), transparent);
-  border-left: 3px solid var(--flock-accent);
-  padding-left: calc(0.6rem + 3px);
-}
-
-/* Tab navigation enhancement */
-.md-tabs {
-  overflow-x: auto !important;
-  overflow-y: visible !important;
-  -webkit-mask-image: none !important;
-  mask-image: none !important;
-  margin-top: 0 !important;
-  background: var(--flock-primary-600) !important;
-  padding: 0 !important;
-  height: 60px !important;
-  display: flex !important;
-  align-items: center !important;
-}
-
-.md-tabs__list {
-  white-space: nowrap !important;
-  padding: 0 !important;
-  contain: none !important;
-  width: auto !important;
-  min-width: 100% !important;
-  display: flex !important;
-  align-items: center !important;
-  margin: 0 !important;
-}
-
-.md-tabs__item {
-  display: flex !important;
-  flex: 0 0 auto !important;
-  min-width: auto !important;
-  align-items: center !important;
-}
-
-.md-tabs__link {
-  transition: all var(--flock-transition-base);
-  position: relative;
-  font-weight: 600;
-  font-size: 0.75rem;
-  padding: 0.1rem 0.8rem !important;
-  margin-bottom: 5px;
-  border-radius: 8px 8px 0 0;
-  white-space: nowrap !important;
-  overflow: visible !important;
-  text-overflow: clip !important;
-  max-width: none !important;
-  width: auto !important;
-  display: flex !important;
-  align-items: center !important;
-  flex: 20 20 auto !important;
-  min-width: fit-content !important;
-}
-
-.md-tabs__link:hover {
-  background: var(--flock-primary-400);
-  transform: translateY(-2px);
-}
-
-.md-tabs__link::after {
-  content: '';
-  position: absolute;
-  bottom: 0;
-  left: 0;
-  right: 0;
-  height: 3px;
-  background: linear-gradient(90deg, #06b6d4, #10b981);
-  transform: scaleX(0);
-  transition: transform var(--flock-transition-base);
-  border-radius: 2px 2px 0 0;
-  box-shadow: 0 0 15px rgba(6, 182, 212, 0.5);
-}
-
-.md-tabs__link:hover::after,
-.md-tabs__link--active::after {
-  transform: scaleX(1);
-}
-
-.md-tabs__link--active {
-  background: rgba(255, 255, 255, 0.05);
-}
-
-/* ============================================
-   IMPROVED SEARCH
-   ============================================ */
-
-.md-search__form {
-  border-radius: 24px;
-  transition: box-shadow var(--flock-transition-base);
-}
-
-.md-search__form:hover,
-.md-search__form:focus-within {
-  box-shadow: var(--flock-shadow-md);
-}
-
-.md-search__input {
-  border-radius: 24px;
-}
-
-/* ============================================
-   ENHANCED BUTTONS & LINKS
-   ============================================ */
-
-.md-button {
-  border-radius: 8px;
-  font-weight: 600;
-  text-transform: uppercase;
-  letter-spacing: 0.05em;
-  transition: all var(--flock-transition-base);
-  box-shadow: var(--flock-shadow-sm);
-}
-
-.md-button:hover {
-  transform: translateY(-2px);
-  box-shadow: var(--flock-shadow-md);
-}
-
-.md-button--primary {
-  background: linear-gradient(135deg, var(--flock-gradient-start), var(--flock-gradient-end));
-}
-
-/* Enhanced link hover effects */
-.md-typeset a {
-  transition: all var(--flock-transition-fast);
-  position: relative;
-}
-
-.md-typeset a:not(.md-button)::after {
-  content: '';
-  position: absolute;
-  bottom: -2px;
-  left: 0;
-  width: 0;
-  height: 2px;
-  background: linear-gradient(90deg, var(--flock-gradient-start), var(--flock-gradient-end));
-  transition: width var(--flock-transition-base);
-}
-
-.md-typeset a:not(.md-button):hover::after {
-  width: 100%;
-}
-
-/* ============================================
-   IMPROVED HEADINGS
-   ============================================ */
-
-.md-typeset h1,
-.md-typeset h2 {
-  font-weight: 700;
-  letter-spacing: -0.025em;
-}
-
-.md-typeset h1 {
-  background: linear-gradient(135deg, var(--flock-gradient-start), var(--flock-gradient-end));
-  -webkit-background-clip: text;
-  -webkit-text-fill-color: transparent;
-  background-clip: text;
-}
-
-.md-typeset h2 {
-  border-bottom: 2px solid;
-  border-image: linear-gradient(90deg, var(--flock-gradient-start), transparent) 1;
-  padding-bottom: 0.5rem;
-}
-
-/* Permalink hover effect */
-.md-typeset .headerlink {
-  opacity: 0;
-  transition: opacity var(--flock-transition-fast), transform var(--flock-transition-fast);
-  transform: translateX(-4px);
-}
-
-.md-typeset :hover > .headerlink {
-  opacity: 0.5;
-  transform: translateX(0);
-}
-
-.md-typeset .headerlink:hover {
-  opacity: 1 !important;
-  transform: scale(1.2);
-}
-
-/* ============================================
-   BACK TO TOP BUTTON REMOVED
-   ============================================ */
-
-.md-top {
-  display: none !important;
-}
 
 /* ============================================
    FOOTER NAVIGATION ENHANCEMENT

flock_core-0.5.0b61/docs/whiteducksoftware/versions.json

@@ -0,0 +1,7 @@
+[
+  {
+    "version": "0.5.0",
+    "title": "0.5.0 (latest)",
+    "aliases": ["latest"]
+  }
+]

{flock_core-0.5.0b60 → flock_core-0.5.0b61}/mkdocs.yml

@@ -71,11 +71,6 @@ plugins:
   - search:
       separator: '[\s\-,:!=\[\]()"`/]+|\.(?!\d)|&[lg]t;|(?!\b)(?=[A-Z][a-z])'
   - tags
-  - social:
-      cards: true
-      cards_layout_options:
-        background_color: "#4f46e5"
-        color: "#ffffff"
   - gen-files:
       scripts:
         - scripts/gen_ref_pages.py
@@ -196,6 +191,7 @@ extra:
 nav:
   - 🏠 Home: index.md
   - 🚀 Getting Started:
+    - Overview: getting-started/index.md
     - Installation: getting-started/installation.md
     - Quick Start: getting-started/quick-start.md
     - Core Concepts: getting-started/concepts.md
@@ -208,6 +204,7 @@ nav:
     - Advanced Patterns: tutorials/advanced-patterns.md
 
   - 📚 User Guides:
+    - Overview: guides/index.md
     - Agents: guides/agents.md
     - Agent Components: guides/components.md
     - Blackboard: guides/blackboard.md
@@ -231,7 +228,8 @@ nav:
     - Configuration: reference/configuration.md
 
   - 💡 Examples:
-    - Overview: https://github.com/whiteducksoftware/flock/tree/main/examples
+    - Overview: examples/index.md
+    - GitHub Examples: https://github.com/whiteducksoftware/flock/tree/main/examples
     - Showcase: https://github.com/whiteducksoftware/flock/tree/main/examples/showcase
     - Features: https://github.com/whiteducksoftware/flock/tree/main/examples/features
     - Dashboard: https://github.com/whiteducksoftware/flock/tree/main/examples/03-the-dashboard
@@ -242,6 +240,7 @@ nav:
     - Changelog: about/changelog.md
 
   - 💬 Community:
+    - Overview: community/index.md
     - GitHub: https://github.com/whiteducksoftware/flock
     - Issues: https://github.com/whiteducksoftware/flock/issues
     - Discussions: https://github.com/whiteducksoftware/flock/discussions

{flock_core-0.5.0b60 → flock_core-0.5.0b61}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "flock-core"
-version = "0.5.0b60"
+version = "0.5.0b61"
 description = "Add your description here"
 readme = "README.md"
 authors = [
@@ -91,8 +91,6 @@ dev = [
     "mkdocs-git-revision-date-localized-plugin>=1.3.0",
     "mkdocs-redirects>=1.2.2",
     "mkdocs-glightbox>=0.4.0",
-    "cairosvg>=2.7.0",
-    "pillow>=10.0.0",
     "mypy>=1.15.0",
     "pre-commit>=4.3.0",
     "bandit[toml]>=1.8.6",
@@ -103,14 +101,6 @@ dev = [
     "jupyterlab>=4.3.3",
 ]
 
-comparison = [
-    "langgraph>=0.6.8",
-    "langchain-openai>=0.2.0",
-    "autogen-agentchat>=0.7.5",
-    "autogen-ext>=0.7.4",
-]
-
-
 [tool.poe.tasks]
 _sync = "uv sync --dev --all-groups --all-extras"
 _build = "uv build"

{flock_core-0.5.0b60 → flock_core-0.5.0b61}/src/flock/dashboard/service.py

@@ -818,7 +818,7 @@ class DashboardHTTPService(BlackboardHTTPService):
         await self.websocket_manager.shutdown()
         logger.info("DashboardHTTPService stopped")
 
-    def get_app(self):
+    def get_app(self) -> Any:
         """Get FastAPI application instance.
 
         Returns:

{flock_core-0.5.0b60 → flock_core-0.5.0b61}/src/flock/orchestrator.py

@@ -286,7 +286,7 @@ class Flock(metaclass=AutoTracedMeta):
     # Unified Tracing ------------------------------------------------------
 
     @asynccontextmanager
-    async def traced_run(self, name: str = "workflow"):
+    async def traced_run(self, name: str = "workflow") -> AsyncGenerator[Any, None]:
         """Context manager for wrapping an entire execution in a single unified trace.
 
         This creates a parent span that encompasses all operations (publish, run_until_idle, etc.)
@@ -670,7 +670,7 @@ class Flock(metaclass=AutoTracedMeta):
         return artifact
 
     async def publish_many(
-        self, objects: Iterable[BaseModel | dict | Artifact], **kwargs
+        self, objects: Iterable[BaseModel | dict | Artifact], **kwargs: Any
     ) -> list[Artifact]:
         """Publish multiple artifacts at once (event-driven).
 

{flock_core-0.5.0b60 → flock_core-0.5.0b61}/src/flock/runtime.py

@@ -66,7 +66,7 @@ class EvalResult(BaseModel):
         cls,
         obj: BaseModel,
         *,
-        agent,
+        agent: Any,
         state: dict | None = None,
         metrics: dict | None = None,
         errors: list[str] | None = None,
@@ -114,7 +114,7 @@ class EvalResult(BaseModel):
     def from_objects(
         cls,
         *objs: BaseModel,
-        agent,
+        agent: Any,
         state: dict | None = None,
         metrics: dict | None = None,
         errors: list[str] | None = None,