flock-core 0.2.17__tar.gz → 0.3.1__tar.gz

flock_core-0.3.1/.github/workflows/deploy-documentation.yml

@@ -0,0 +1,17 @@
+name: Deploy MkDocs
+on:
+  push:
+    branches:
+      - master  # or master
+      - docs/*  # or docs/*
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+      - run: pip install mkdocs-material mkdocs mkdocstrings[python]
+      - run: mkdocs gh-deploy --force

{flock_core-0.2.17 → flock_core-0.3.1}/.github/workflows/deploy-whiteduck-pypi.yml

@@ -6,6 +6,8 @@ on:
   push:
     branches:
       - master # Replace with your default branch
+    paths:
+      - 'pyproject.toml'  # Only trigger on changes to pyproject.toml (version number)
 
 jobs:
   build-and-publish:

{flock_core-0.2.17 → flock_core-0.3.1}/.gitignore

@@ -26,6 +26,7 @@ share/python-wheels/
 *.egg
 MANIFEST
 logs/
+metrics/
 
 
 # PyInstaller

{flock_core-0.2.17 → flock_core-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flock-core
-Version: 0.2.17
+Version: 0.3.1
 Summary: Declarative LLM Orchestration at Scale
 Author-email: Andre Ratzenberger <andre.ratzenberger@whiteduck.de>
 License-File: LICENSE
@@ -14,6 +14,7 @@ Requires-Dist: dspy==2.5.42
 Requires-Dist: duckduckgo-search>=7.3.2
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: loguru>=0.7.3
+Requires-Dist: matplotlib>=3.10.0
 Requires-Dist: msgpack>=1.1.0
 Requires-Dist: opentelemetry-api>=1.30.0
 Requires-Dist: opentelemetry-exporter-jaeger-proto-grpc>=1.21.0
@@ -21,13 +22,18 @@ 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: pillow>=10.4.0
+Requires-Dist: prometheus-client>=0.21.1
 Requires-Dist: pydantic>=2.10.5
 Requires-Dist: python-box>=7.3.2
 Requires-Dist: python-decouple>=3.8
 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
 Provides-Extra: all-tools
 Requires-Dist: docling>=2.18.0; extra == 'all-tools'
 Requires-Dist: markdownify>=0.14.1; extra == 'all-tools'
@@ -38,7 +44,7 @@ Requires-Dist: tavily-python>=0.5.0; extra == 'tools'
 Description-Content-Type: text/markdown
 
 <p align="center">
-<img src="docs/img/flock.png" width="600"><br>
+<img src="docs/assets/images/flock.png" width="600"><br>
 <img alt="Dynamic TOML Badge" src="https://img.shields.io/badge/dynamic/toml?url=https%3A%2F%2Fraw.githubusercontent.com%2Fwhiteducksoftware%2Fflock%2Frefs%2Fheads%2Fmaster%2Fpyproject.toml&query=%24.project.version&style=for-the-badge&logo=pypi&label=pip%20version">
 <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>
@@ -69,7 +75,15 @@ Flock is a framework for orchestrating LLM-powered agents. It leverages a **decl
 
 https://github.com/user-attachments/assets/bdab4786-d532-459f-806a-024727164dcc
 
+## Table of Contents
 
+- [Key Innovations](#key-innovations)
+- [Examples](#examples)
+  - [Hello Flock!](#hello-flock)
+  - [It's not my type](#its-not-my-type)
+  - [Being pydantic](#being-pydantic)
+  - [Building a chain gang!](#building-a-chain-gang)
+- [Installation](#installation)
 
 
 ## Key Innovations
@@ -96,7 +110,7 @@ https://github.com/user-attachments/assets/bdab4786-d532-459f-806a-024727164dcc
 
 
 <p align="center">
-<img src="docs/img/flock_cli.png" width="200"><br>
+<img src="docs/assets/images//flock_cli.png" width="200"><br>
 
 ## Examples
 
@@ -294,6 +308,98 @@ And BAM! Your finished data model filled up to the brim with data! 🎊
 }
 ```
 
+### Building a chain gang
+
+Our `bloggy` is great, but what if we want to turn those amazing headers into full blog posts? Time to bring in a friend! 🤝
+Let's see how easy it is to make agents work together 🔗
+
+```python
+from flock.core import Flock, FlockAgent
+
+flock = Flock(model="openai/gpt-4o")
+
+# First agent: Our trusty bloggy generates titles and headers! 📝
+bloggy = FlockAgent(
+    name="bloggy",
+    input="blog_idea: str|The topic to blog about",
+    output=(
+        "funny_blog_title: str|A catchy title for the blog, "
+        "blog_headers: list[str]|List of section headers for the blog"
+    )
+)
+
+# Second agent: The content wizard that brings headers to life! ✨
+content_writer = FlockAgent(
+    name="content_writer",
+    input=(
+        "funny_blog_title: str|The blog title to work with, "
+        "blog_headers: list[str]|The headers to expand into content"
+    ),
+    output="blog_sections: list[BlogSection]|The fully written blog sections"
+)
+
+# Make them besties! 🤝
+bloggy.hand_off = content_writer
+
+# Add your dynamic duo to the flock
+flock.add_agent(bloggy)
+flock.add_agent(content_writer)
+
+# Let them create some magic! 🎨
+result = flock.run(
+    input={"blog_idea": "A blog about cats"},
+    start_agent=bloggy
+)
+```
+
+Super simple rules to remember:
+1. Point the first agent to the next one using `hand_off`
+2. Make sure their inputs and outputs match up
+
+### Tools of the trade
+
+Of couse no agent framework is complete without using tools.
+Flock enables agents to use any python function you pass as tool or to use one of the plenty default tools
+
+```python
+bloggy = FlockAgent(
+    name="bloggy",
+    input="blog_idea: str|The topic to blog about",
+    output=(
+        "funny_blog_title: str|A catchy title for the blog, "
+        "blog_headers: list[str]|List of section headers for the blog"
+        "analysis_results: dict[str,Any] | Result of calculated analysis if necessary"
+    )
+    tools=[basic_tools.web_search_duckduckgo, basic_tools.code_eval],
+)
+
+result = flock.run(
+    input={"blog_idea": "A blog about cats, with an analysis how old the oldest cat became in days"},
+    start_agent=bloggy
+)
+```
+
+These tools are available out of the box (needs `flock-core[tools]`):
+
+- web_search_tavily
+- web_search_duckduckgo
+- get_web_content_as_markdown
+- get_anything_as_markdown (uses docling and needs `flock-core[all-tools]`)
+- evaluate_math
+- code_eval
+- get_current_time
+- count_words
+- extract_urls
+- extract_numbers
+- json_parse_safe
+- save_to_file
+- read_from_file
+
+
+That's all there is to it! `bloggy` comes up with amazing headers, and `content_writer` turns them into full blog sections. No more writer's block! 🎉
+
+And this is just the beginning - you can chain as many agents as you want. Maybe add a proofreader? Or add memory? Or an SEO optimizer? But let's not get ahead of ourselves! 😉
+
 So far we've barely scratched the surface of what flock has to offer, and we're currently hard at work building up the documentation for all the other super cool features Flock has up its sleeve! Stay tuned! 🚀
 
 ## Temporal Workflow Integration
@@ -308,7 +414,9 @@ Documentation in progress!
 
 ## Architecture
 
-Documentation in progress!
+<img src="docs/assets/images/components_chart.png" width="800"><br>
+
+<img src="docs/assets/images/flow_chart.png" width="800"><br>
 
 
 ## Requirements

{flock_core-0.2.17 → flock_core-0.3.1}/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-<img src="docs/img/flock.png" width="600"><br>
+<img src="docs/assets/images/flock.png" width="600"><br>
 <img alt="Dynamic TOML Badge" src="https://img.shields.io/badge/dynamic/toml?url=https%3A%2F%2Fraw.githubusercontent.com%2Fwhiteducksoftware%2Fflock%2Frefs%2Fheads%2Fmaster%2Fpyproject.toml&query=%24.project.version&style=for-the-badge&logo=pypi&label=pip%20version">
 <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>
@@ -30,7 +30,15 @@ Flock is a framework for orchestrating LLM-powered agents. It leverages a **decl
 
 https://github.com/user-attachments/assets/bdab4786-d532-459f-806a-024727164dcc
 
+## Table of Contents
 
+- [Key Innovations](#key-innovations)
+- [Examples](#examples)
+  - [Hello Flock!](#hello-flock)
+  - [It's not my type](#its-not-my-type)
+  - [Being pydantic](#being-pydantic)
+  - [Building a chain gang!](#building-a-chain-gang)
+- [Installation](#installation)
 
 
 ## Key Innovations
@@ -57,7 +65,7 @@ https://github.com/user-attachments/assets/bdab4786-d532-459f-806a-024727164dcc
 
 
 <p align="center">
-<img src="docs/img/flock_cli.png" width="200"><br>
+<img src="docs/assets/images//flock_cli.png" width="200"><br>
 
 ## Examples
 
@@ -255,6 +263,98 @@ And BAM! Your finished data model filled up to the brim with data! 🎊
 }
 ```
 
+### Building a chain gang
+
+Our `bloggy` is great, but what if we want to turn those amazing headers into full blog posts? Time to bring in a friend! 🤝
+Let's see how easy it is to make agents work together 🔗
+
+```python
+from flock.core import Flock, FlockAgent
+
+flock = Flock(model="openai/gpt-4o")
+
+# First agent: Our trusty bloggy generates titles and headers! 📝
+bloggy = FlockAgent(
+    name="bloggy",
+    input="blog_idea: str|The topic to blog about",
+    output=(
+        "funny_blog_title: str|A catchy title for the blog, "
+        "blog_headers: list[str]|List of section headers for the blog"
+    )
+)
+
+# Second agent: The content wizard that brings headers to life! ✨
+content_writer = FlockAgent(
+    name="content_writer",
+    input=(
+        "funny_blog_title: str|The blog title to work with, "
+        "blog_headers: list[str]|The headers to expand into content"
+    ),
+    output="blog_sections: list[BlogSection]|The fully written blog sections"
+)
+
+# Make them besties! 🤝
+bloggy.hand_off = content_writer
+
+# Add your dynamic duo to the flock
+flock.add_agent(bloggy)
+flock.add_agent(content_writer)
+
+# Let them create some magic! 🎨
+result = flock.run(
+    input={"blog_idea": "A blog about cats"},
+    start_agent=bloggy
+)
+```
+
+Super simple rules to remember:
+1. Point the first agent to the next one using `hand_off`
+2. Make sure their inputs and outputs match up
+
+### Tools of the trade
+
+Of couse no agent framework is complete without using tools.
+Flock enables agents to use any python function you pass as tool or to use one of the plenty default tools
+
+```python
+bloggy = FlockAgent(
+    name="bloggy",
+    input="blog_idea: str|The topic to blog about",
+    output=(
+        "funny_blog_title: str|A catchy title for the blog, "
+        "blog_headers: list[str]|List of section headers for the blog"
+        "analysis_results: dict[str,Any] | Result of calculated analysis if necessary"
+    )
+    tools=[basic_tools.web_search_duckduckgo, basic_tools.code_eval],
+)
+
+result = flock.run(
+    input={"blog_idea": "A blog about cats, with an analysis how old the oldest cat became in days"},
+    start_agent=bloggy
+)
+```
+
+These tools are available out of the box (needs `flock-core[tools]`):
+
+- web_search_tavily
+- web_search_duckduckgo
+- get_web_content_as_markdown
+- get_anything_as_markdown (uses docling and needs `flock-core[all-tools]`)
+- evaluate_math
+- code_eval
+- get_current_time
+- count_words
+- extract_urls
+- extract_numbers
+- json_parse_safe
+- save_to_file
+- read_from_file
+
+
+That's all there is to it! `bloggy` comes up with amazing headers, and `content_writer` turns them into full blog sections. No more writer's block! 🎉
+
+And this is just the beginning - you can chain as many agents as you want. Maybe add a proofreader? Or add memory? Or an SEO optimizer? But let's not get ahead of ourselves! 😉
+
 So far we've barely scratched the surface of what flock has to offer, and we're currently hard at work building up the documentation for all the other super cool features Flock has up its sleeve! Stay tuned! 🚀
 
 ## Temporal Workflow Integration
@@ -269,7 +369,9 @@ Documentation in progress!
 
 ## Architecture
 
-Documentation in progress!
+<img src="docs/assets/images/components_chart.png" width="800"><br>
+
+<img src="docs/assets/images/flow_chart.png" width="800"><br>
 
 
 ## Requirements

flock_core-0.3.1/docs/advanced/complex-workflows.md

@@ -0,0 +1,3 @@
+# Complex Workflows
+
+Documentation in progress...

flock_core-0.3.1/docs/advanced/custom-agents.md

@@ -0,0 +1,3 @@
+# Custom Agents
+
+Documentation in progress...

flock_core-0.3.1/docs/advanced/performance.md

@@ -0,0 +1,3 @@
+# Performance
+
+Documentation in progress...

flock_core-0.3.1/docs/advanced/testing.md

@@ -0,0 +1,3 @@
+# Testing
+
+Documentation in progress...

flock_core-0.3.1/docs/api/flock-core.md

@@ -0,0 +1,3 @@
+# Flock Core
+
+Documentation in progress...

flock_core-0.3.1/docs/api/flockagent.md

@@ -0,0 +1,3 @@
+# Flockagent
+
+Documentation in progress...

flock_core-0.3.1/docs/api/types.md

@@ -0,0 +1,3 @@
+# Types
+
+Documentation in progress...

flock_core-0.3.1/docs/api/utilities.md

@@ -0,0 +1,3 @@
+# Utilities
+
+Documentation in progress...

flock_core-0.3.1/docs/architecture/components.md

@@ -0,0 +1,3 @@
+# Components
+
+Documentation in progress...

flock_core-0.3.1/docs/architecture/design-decisions.md

@@ -0,0 +1,3 @@
+# Design Decisions
+
+Documentation in progress...

flock_core-0.3.1/docs/architecture/overview.md

@@ -0,0 +1,3 @@
+# Overview
+
+Documentation in progress...

flock_core-0.3.1/docs/assets/drawio/architecture.drawio

@@ -0,0 +1,44 @@
+<mxfile host="65bd71144e">
+    <diagram id="iQ7YuHOuaVDECIdskFDT" name="Page-1">
+        <mxGraphModel dx="88" dy="620" grid="0" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="850" pageHeight="1100" background="light-dark(#FFFFFF, #d8cfb1)" math="0" shadow="1">
+            <root>
+                <mxCell id="0"/>
+                <mxCell id="1" parent="0"/>
+                <mxCell id="2" value="sequenceDiagram&#xa;    participant Client&#xa;    participant Flock&#xa;    participant FlockAgent&#xa;    participant Registry&#xa;    participant Context&#xa;    participant LLM&#xa;    &#xa;    Client-&gt;&gt;Flock: run_async(agent, input)&#xa;    Flock-&gt;&gt;Registry: get_agent(name)&#xa;    Registry--&gt;&gt;Flock: agent instance&#xa;    &#xa;    Flock-&gt;&gt;Context: initialize_context(agent, input)&#xa;    &#xa;    Flock-&gt;&gt;FlockAgent: run(inputs)&#xa;    activate FlockAgent&#xa;    &#xa;    FlockAgent-&gt;&gt;FlockAgent: initialize(inputs)&#xa;    FlockAgent-&gt;&gt;FlockAgent: _evaluate(inputs)&#xa;    &#xa;    FlockAgent-&gt;&gt;LLM: process with tools/prompts&#xa;    LLM--&gt;&gt;FlockAgent: response&#xa;    &#xa;    FlockAgent-&gt;&gt;FlockAgent: terminate(inputs, result)&#xa;    FlockAgent--&gt;&gt;Flock: result&#xa;    deactivate FlockAgent&#xa;    &#xa;    Flock--&gt;&gt;Client: final result" style="shadow=0;dashed=0;align=left;strokeWidth=1;shape=mxgraph.mermaid.abstract.mermaid;labelBackgroundColor=#ffffff;noLabel=1;theme=default;" parent="1" vertex="1">
+                    <mxGeometry x="271" y="360" width="300" height="300" as="geometry"/>
+                </mxCell>
+            </root>
+        </mxGraphModel>
+    </diagram>
+    <diagram id="mQwFuZfSuTjpqv4SXbYC" name="Page-2">
+        <mxGraphModel dx="354" dy="259" grid="0" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="850" pageHeight="1100" background="light-dark(#FFFFFF, #ffffde)" math="0" shadow="1">
+            <root>
+                <mxCell id="0"/>
+                <mxCell id="1" parent="0"/>
+                <mxCell id="gh-ZxXSGDDD0mwRwWCxR-1" value="graph TD&#xa;    subgraph Client Application&#xa;        client[Client Code]&#xa;    end&#xa;&#xa;    subgraph Flock Framework&#xa;        orchestrator[Flock Orchestrator]&#xa;        registry[Agent Registry]&#xa;        context[Context Manager]&#xa;        &#xa;        subgraph Agents&#xa;            base[FlockAgent Base]&#xa;&#xa;        end&#xa;        &#xa;        subgraph Execution&#xa;            local[Local Executor]&#xa;            temporal[Temporal Executor]&#xa;        end&#xa;        &#xa;        subgraph Core Services&#xa;            logging[Logging System]&#xa;            tools[Tool Registry]&#xa;            formatter[Output Formatters]&#xa;        end&#xa;    end&#xa;&#xa;    subgraph External Services&#xa;        llm[Language Models]&#xa;        temporal_server[Temporal Server]&#xa;    end&#xa;&#xa;    %% Client interactions&#xa;    client --&gt; orchestrator&#xa;    &#xa;    %% Orchestrator relations&#xa;    orchestrator --&gt; registry&#xa;    orchestrator --&gt; context&#xa;    orchestrator --&gt; local&#xa;    orchestrator --&gt; temporal&#xa;    &#xa;    %% Agent relations&#xa;    base --&gt; tools&#xa;    base --&gt; logging&#xa;    base --&gt; formatter&#xa;&#xa;    &#xa;    %% Execution relations&#xa;    local --&gt; llm&#xa;    temporal --&gt; temporal_server&#xa;    temporal_server --&gt; llm&#xa;    &#xa;    %% Registry relations&#xa;    registry --&gt; base&#xa;    registry --&gt; tools&#xa;&#xa;    %% Style&#xa;    classDef default fill:#f9f9f9,stroke:#333,stroke-width:2px;&#xa;    classDef external fill:#e1f5fe,stroke:#0288d1,stroke-width:2px;&#xa;    classDef core fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px;&#xa;    &#xa;    class llm,temporal_server external;&#xa;    class orchestrator,registry,context,base,local,temporal core;" style="shadow=0;dashed=0;align=left;strokeWidth=1;shape=mxgraph.mermaid.abstract.mermaid;labelBackgroundColor=#ffffff;noLabel=1;theme=default;" vertex="1" parent="1">
+                    <mxGeometry x="274" y="325" width="300" height="300" as="geometry"/>
+                </mxCell>
+            </root>
+        </mxGraphModel>
+    </diagram>
+    <diagram id="sh9ImpPZNdK_Mo0HMCRx" name="Page-3">
+        <mxGraphModel dx="1237" dy="800" grid="0" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="0" pageScale="1" pageWidth="850" pageHeight="1100" background="light-dark(#FFFFFF,#E8E8E8)" math="0" shadow="0">
+            <root>
+                <mxCell id="0"/>
+                <mxCell id="1" parent="0"/>
+                <mxCell id="84CqISvRR4rrSDVKXhkM-1" value="graph TD&#xa;    subgraph Memory Storage&#xa;        A[New Input/Output] --&gt; B[Create Embedding]&#xa;        B --&gt; C[Extract Concepts]&#xa;        C --&gt; D[Create Memory Entry]&#xa;        D --&gt; E{Store Memory}&#xa;        E --&gt;|Recent| F[Short Term Memory]&#xa;        E --&gt;|Frequent Use| G[Long Term Memory]&#xa;        D --&gt; H[Update Concept Graph]&#xa;    end&#xa;&#xa;classDef process fill:#73B7E7,stroke:#333,stroke-width:2px;&#xa;classDef storage fill:#90EE90,stroke:#333,stroke-width:2px;&#xa;class A,B,C,D process;&#xa;class F,G,H storage;" style="shadow=0;dashed=0;align=left;strokeWidth=1;shape=mxgraph.mermaid.abstract.mermaid;labelBackgroundColor=#ffffff;noLabel=1;theme=default;" parent="1" vertex="1">
+                    <mxGeometry x="-20" y="10" width="300" height="300" as="geometry"/>
+                </mxCell>
+                <mxCell id="84CqISvRR4rrSDVKXhkM-2" value="graph TD&#xa;    subgraph Memory Retrieval&#xa;        A1[Query] --&gt; B1[Create Query Embedding]&#xa;        A1 --&gt; C1[Extract Query Concepts]&#xa;        B1 --&gt; D1{Similarity Search}&#xa;        C1 --&gt; E1{Concept Spreading}&#xa;        D1 --&gt; F1[Find Similar Memories]&#xa;        E1 --&gt; G1[Find Related Concepts]&#xa;        F1 --&gt; H1[Score &amp; Rank Results]&#xa;        G1 --&gt; H1&#xa;        H1 --&gt; I1[Return Best Matches]&#xa;    end&#xa;&#xa;classDef query fill:#FFB6C1,stroke:#333,stroke-width:2px;&#xa;classDef process fill:#73B7E7,stroke:#333,stroke-width:2px;&#xa;classDef result fill:#90EE90,stroke:#333,stroke-width:2px;&#xa;class A1,B1,C1 query;&#xa;class D1,E1,F1,G1 process;&#xa;class H1,I1 result;&#xa;" style="shadow=0;dashed=0;align=left;strokeWidth=1;shape=mxgraph.mermaid.abstract.mermaid;labelBackgroundColor=#ffffff;noLabel=1;theme=default;" parent="1" vertex="1">
+                    <mxGeometry x="240" y="10" width="300" height="300" as="geometry"/>
+                </mxCell>
+                <mxCell id="84CqISvRR4rrSDVKXhkM-3" value="graph LR&#xa;    subgraph Concept Graph&#xa;        A2[Space] --&gt; B2[Rockets]&#xa;        B2 --&gt; C2[Physics]&#xa;        C2 --&gt; D2[Energy]&#xa;        B2 --&gt; E2[Engineering]&#xa;        A2 --&gt; F2[Astronomy]&#xa;        F2 --&gt; G2[Planets]&#xa;    end&#xa;&#xa;classDef concept fill:#FFE4B5,stroke:#333,stroke-width:2px;&#xa;class A2,B2,C2,D2,E2,F2,G2 concept;" style="shadow=0;dashed=0;align=left;strokeWidth=1;shape=mxgraph.mermaid.abstract.mermaid;labelBackgroundColor=#ffffff;noLabel=1;theme=default;" parent="1" vertex="1">
+                    <mxGeometry x="520" y="-60" width="300" height="300" as="geometry"/>
+                </mxCell>
+                <mxCell id="84CqISvRR4rrSDVKXhkM-4" value="sequenceDiagram&#xa;    participant Q as Query&#xa;    participant M as Memory System&#xa;    participant ST as Short Term&#xa;    participant LT as Long Term&#xa;    participant CG as Concept Graph&#xa;&#xa;    Q-&gt;&gt;M: Search Request&#xa;    activate M&#xa;    M-&gt;&gt;ST: Check Recent Memories&#xa;    M-&gt;&gt;LT: Check Important Memories&#xa;    M-&gt;&gt;CG: Spread Activation&#xa;    CG--&gt;&gt;M: Related Concepts&#xa;    ST--&gt;&gt;M: Similar Recent Memories&#xa;    LT--&gt;&gt;M: Similar Important Memories&#xa;    M-&gt;&gt;M: Score &amp; Rank Results&#xa;    M--&gt;&gt;Q: Return Best Matches&#xa;    deactivate M" style="shadow=0;dashed=0;align=left;strokeWidth=1;shape=mxgraph.mermaid.abstract.mermaid;labelBackgroundColor=#ffffff;noLabel=1;theme=default;" parent="1" vertex="1">
+                    <mxGeometry y="290" width="820" height="650" as="geometry"/>
+                </mxCell>
+            </root>
+        </mxGraphModel>
+    </diagram>
+</mxfile>

flock_core-0.3.1/docs/contributing/code-style.md

@@ -0,0 +1,3 @@
+# Code Style
+
+Documentation in progress...

flock_core-0.3.1/docs/contributing/development.md

@@ -0,0 +1,3 @@
+# Development
+
+Documentation in progress...

flock_core-0.3.1/docs/contributing/documentation.md

@@ -0,0 +1,3 @@
+# Documentation
+
+Documentation in progress...

flock_core-0.3.1/docs/contributing/testing.md

@@ -0,0 +1,3 @@
+# Testing
+
+Documentation in progress...

flock_core-0.3.1/docs/core-concepts/agents.md

@@ -0,0 +1,3 @@
+# Agents
+
+Documentation in progress...

flock_core-0.3.1/docs/core-concepts/declarative.md

@@ -0,0 +1,3 @@
+# Declarative
+
+Documentation in progress...

flock_core-0.3.1/docs/core-concepts/error-handling.md

@@ -0,0 +1,3 @@
+# Error Handling
+
+Documentation in progress...