feat: examples

.gitignore

@@ -13,7 +13,7 @@ __pycache__/
 .DS_Store
 flock-showcase/
 .showcase/
-
+report.md
 # Distribution / packaging
 .Python
 build/

examples/04-using-a-tool.py → examples/03-using-a-tool.py

@@ -25,10 +25,12 @@ def write_file(string: str, file_path: str) -> None:
 
 agent = FlockFactory.create_default_agent(
     name="my_agent",
+    description="Analyses an URI and writes a report to report.md",
     input="url",
     output="title, headings: list[str],"
     "entities_and_metadata: list[dict[str, str]],"
-    "type:Literal['news', 'blog', 'opinion piece', 'tweet']",
+    "type:Literal['news', 'blog', 'opinion piece', 'tweet'],"
+    "output_path: str",
     servers=[read_website_fast_mcp_server],
     tools=[write_file],
     enable_rich_tables=True,  # Instead of the json output, you can use the rich library to render the output as a table

pyproject.toml

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

report.md

@@ -0,0 +1,38 @@
+# Report on: How Alexander the Great redrew the map of the world (CNN)
+
+## Title
+How Alexander the Great redrew the map of the world
+
+## Headings/Sections
+- How Alexander the Great redrew the map of the world (Intro & overview)
+- A mysterious death
+- ‘He overcame everything’
+- Projecting our fantasies
+- A racist legacy?
+- Following in Alexander’s footsteps
+- End of the rainbow
+
+## Entities and Metadata
+- **Alexander the Great**: Main subject; king of Macedon (336 BCE-323 BCE), conqueror of the Persian Empire.
+- **Macedon/Macedonia**: Alexander’s kingdom (modern Greece)
+- **Persian Empire**: Conquered by Alexander; ruled by Darius III at the time
+- **Darius III**: Last king of the Achaemenid Empire
+- **Philip II**: Alexander's father; assassinated
+- **Babylon**: Where Alexander died
+- **Egypt, Turkey, Pakistan, Iran, Afghanistan, India, Greece, Bulgaria, Uzbekistan, etc.**: Regions/entities mentioned, places connected to Alexander's campaigns or legacy
+- **Paul Cartledge**: AG Leventis professor emeritus of Greek culture, Cambridge
+- **Pierre Briant**: Professor emeritus, Collège de France; historian of Achaemenid Empire
+- **Peter Sommer**: UK tour operator and Alexander enthusiast
+- **Blogs (Mega Alexandros), and Literary Works (Shahnamah, Alexander Romance, etc.)**
+- **Cities/sites**: Aigai, Pella, Alexandria, Persepolis, Susa, Pasargadae, Dion, Philippi, Thessaloniki, Perperikon, St. Mark’s Basilica (Venice)
+- **Cultural references**: Hellenization, Zoroastrianism, Greek/Roman perspectives, European myth
+- **Publication**: CNN, Author: Julia Buckley, CNN, Published/updated: Feb 1, 2025
+- **Type**: Feature travel/history article
+- **Length**: ~12 min read
+- **Links/Additional resources**: Numerous embedded links to related articles, scholarly works, museums, and blogs
+
+## Article Type
+Historical/cultural feature with a travel focus (for a general audience). Combines historical analysis, exploration of Alexander's legacy, and suggestions for travel to historical sites.
+
+## Output Path
+report.md