fast-agent-mcp 0.1.12__tar.gz → 0.2.0__tar.gz

{fast_agent_mcp-0.1.12 → fast_agent_mcp-0.2.0}/.gitignore

@@ -182,3 +182,5 @@ fastagent.secrets.yaml
 CLAUDE.md
 example-outputs/
 
+tests/integration/prompt-state/simple.txt
+tests/integration/workflow/router/fastagent.jsonl

{fast_agent_mcp-0.1.12 → fast_agent_mcp-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.1.12
+Version: 0.2.0
 Summary: Define, Prompt and Test MCP enabled Agents and Workflows
 Author-email: Shaun Smith <fastagent@llmindset.co.uk>, Sarmad Qadri <sarmad@lastmileai.dev>
 License:                                  Apache License
@@ -212,7 +212,7 @@ Requires-Python: >=3.10
 Requires-Dist: aiohttp>=3.11.13
 Requires-Dist: anthropic>=0.49.0
 Requires-Dist: fastapi>=0.115.6
-Requires-Dist: mcp>=1.5.0
+Requires-Dist: mcp==1.6.0
 Requires-Dist: numpy>=2.2.1
 Requires-Dist: openai>=1.63.2
 Requires-Dist: opentelemetry-distro>=0.50b0
@@ -224,13 +224,12 @@ Requires-Dist: pyyaml>=6.0.2
 Requires-Dist: rich>=13.9.4
 Requires-Dist: scikit-learn>=1.6.0
 Requires-Dist: typer>=0.15.1
-Provides-Extra: cohere
-Requires-Dist: cohere>=5.13.4; extra == 'cohere'
 Provides-Extra: dev
 Requires-Dist: anthropic>=0.42.0; extra == 'dev'
 Requires-Dist: pre-commit>=4.0.1; extra == 'dev'
 Requires-Dist: pydantic>=2.10.4; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.21.1; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
 Requires-Dist: pytest>=7.4.0; extra == 'dev'
 Requires-Dist: pyyaml>=6.0.2; extra == 'dev'
 Requires-Dist: ruff>=0.8.4; extra == 'dev'

{fast_agent_mcp-0.1.12/src/mcp_agent/resources → fast_agent_mcp-0.2.0}/examples/data-analysis/analysis-campaign.py

@@ -1,7 +1,7 @@
 import asyncio
 
 from mcp_agent.core.fastagent import FastAgent
-from mcp_agent.workflows.llm.augmented_llm import RequestParams
+from mcp_agent.llm.augmented_llm import RequestParams
 
 # Create the application
 fast = FastAgent("Data Analysis & Campaign Generator")
@@ -172,7 +172,7 @@ Extract key insights that would be compelling for a social media campaign.
     request_params=RequestParams(maxTokens=8192),
     plan_type="full",
 )
-async def main():
+async def main() -> None:
     # Use the app's context manager
     print(
         "WARNING: This workflow will likely run for >10 minutes and consume a lot of tokens. Press Enter to accept the default prompt and proceed"

{fast_agent_mcp-0.1.12/src/mcp_agent/resources → fast_agent_mcp-0.2.0}/examples/data-analysis/analysis.py

@@ -1,7 +1,7 @@
 import asyncio
 
 from mcp_agent.core.fastagent import FastAgent
-from mcp_agent.workflows.llm.augmented_llm import RequestParams
+from mcp_agent.llm.augmented_llm import RequestParams
 
 # Create the application
 fast = FastAgent("Data Analysis (Roots)")
@@ -23,7 +23,7 @@ Visualisations should be saved as .png files in the current working directory.
     servers=["interpreter"],
     request_params=RequestParams(maxTokens=8192),
 )
-async def main():
+async def main() -> None:
     # Use the app's context manager
     async with fast.run() as agent:
         await agent(

{fast_agent_mcp-0.1.12/src/mcp_agent/resources → fast_agent_mcp-0.2.0}/examples/researcher/researcher-eval.py

@@ -41,12 +41,12 @@ Summarize your evaluation as a structured response with:
     min_rating="EXCELLENT",
     name="Researcher_Evaluator",
 )
-async def main():
+async def main() -> None:
     async with agents.run() as agent:
         await agent.prompt("Researcher_Evaluator")
 
         print("Ask follow up quesions to the Researcher?")
-        await agent.prompt("Researcher", default="STOP")
+        await agent.prompt("Researcher", default_prompt="STOP")
 
 
 if __name__ == "__main__":

{fast_agent_mcp-0.1.12/src/mcp_agent/resources → fast_agent_mcp-0.2.0}/examples/researcher/researcher-imp.py

@@ -1,4 +1,5 @@
 import asyncio
+
 from mcp_agent.core.fastagent import FastAgent
 
 agents = FastAgent(name="Enhanced Researcher")
@@ -162,7 +163,7 @@ The researcher should be able to understand exactly why they received their rati
     min_rating="EXCELLENT",
     name="EnhancedResearcher",
 )
-async def main():
+async def main() -> None:
     async with agents.run() as agent:
         # Start with a warm-up to set expectations and explain the research approach
         await agent.Researcher.send(
@@ -180,10 +181,8 @@ async def main():
         # Start the main research workflow
         await agent.prompt("EnhancedResearcher")
 
-        print(
-            "\nWould you like to ask follow-up questions to the Researcher? (Type 'STOP' to end)"
-        )
-        await agent.prompt("Researcher", default="STOP")
+        print("\nWould you like to ask follow-up questions to the Researcher? (Type 'STOP' to end)")
+        await agent.prompt("Researcher", default_prompt="STOP")
 
 
 if __name__ == "__main__":

{fast_agent_mcp-0.1.12/src/mcp_agent/resources → fast_agent_mcp-0.2.0}/examples/researcher/researcher.py

@@ -1,6 +1,7 @@
 import asyncio
 
 from mcp_agent.core.fastagent import FastAgent
+
 # from rich import print
 
 agents = FastAgent(name="Researcher Agent")
@@ -16,7 +17,7 @@ The interpreter has numpy, pandas, matplotlib and seaborn already installed
     """,
     servers=["brave", "interpreter", "filesystem", "fetch"],
 )
-async def main():
+async def main() -> None:
     research_prompt = """
 Produce an investment report for the company Eutelsat. The final report should be saved in the filesystem in markdown format, and
 contain at least the following: 
@@ -30,9 +31,6 @@ Todays date is 15 February 2025. Include the main data sources consulted in pres
     async with agents.run() as agent:
         await agent.prompt()
 
-        # await agent.prompt(default="STOP")
-        #        await agent.prompt(default=research_prompt)
-
 
 if __name__ == "__main__":
     asyncio.run(main())

{fast_agent_mcp-0.1.12/src/mcp_agent/resources → fast_agent_mcp-0.2.0}/examples/workflows/chaining.py

@@ -1,4 +1,5 @@
 import asyncio
+
 from mcp_agent.core.fastagent import FastAgent
 
 # Create the application
@@ -21,19 +22,10 @@ fast = FastAgent("Agent Chaining")
     name="post_writer",
     sequence=["url_fetcher", "social_media"],
 )
-async def main():
+async def main() -> None:
     async with fast.run() as agent:
         # using chain workflow
-        await agent.post_writer.prompt()
-
-        # calling directly
-        # await agent.url_fetcher("http://llmindset.co.uk/resources/mcp-hfspace/")
-        # await agent.social_media(
-        #     await agent.url_fetcher("http://llmindset.co.uk/resources/mcp-hfspace/")
-        # )
-
-        # agents can also be accessed like dictionaries:
-        # awwait agent["post_writer"].prompt()
+        await agent.post_writer.send("https://llmindset.co.uk")
 
 
 # alternative syntax for above is result = agent["post_writer"].send(message)

{fast_agent_mcp-0.1.12/src/mcp_agent/resources → fast_agent_mcp-0.2.0}/examples/workflows/evaluator.py

@@ -3,6 +3,7 @@ This demonstrates creating an optimizer and evaluator to iteratively improve con
 """
 
 import asyncio
+
 from mcp_agent.core.fastagent import FastAgent
 
 # Create the application
@@ -49,7 +50,7 @@ fast = FastAgent("Evaluator-Optimizer")
     min_rating="EXCELLENT",  # Strive for excellence
     max_refinements=3,  # Maximum iterations
 )
-async def main():
+async def main() -> None:
     async with fast.run() as agent:
         job_posting = (
             "Software Engineer at LastMile AI. Responsibilities include developing AI systems, "
@@ -71,8 +72,6 @@ async def main():
             f"Company information: {company_information}",
         )
 
-        await agent()
-
 
 if __name__ == "__main__":
     asyncio.run(main())

fast_agent_mcp-0.2.0/examples/workflows/graded_report.md

@@ -0,0 +1,89 @@
+# Graded Report: "The Kittens Castle Adventure"
+
+## Proofreading Feedback
+
+### Spelling Errors
+1. "Adventuer" → "Adventure"
+2. "lil" → "little"
+3. "name" → "named"
+4. "threw" → "through"
+5. "mystirus" → "mysterious"
+6. "forrest" → "forest"
+7. "was" → "were"
+8. "an" → "and"
+9. "Suddenlee" → "Suddenly"
+10. "sawd" → "saw"
+11. "somthing" → "something"
+12. "chese" → "cheese"
+13. "windos" → "windows"
+14. "turrits" → "turrets"
+15. "tuch" → "touch"
+16. "clowds" → "clouds"
+17. "doars" → "doors"
+18. "enuff" → "enough"
+19. "elefant" → "elephant"
+20. "sed" → "said"
+21. "tale" → "tail"
+22. "poofy" → "puffy"
+23. "fowned" → "found"
+24. "meowed" → added missing period
+25. "smallist" → "smallest"
+26. "rond" → "round"
+27. "climed" → "climbed"
+28. "slip-slidin" → "slip-sliding"
+29. "smoth" → "smooth"
+30. "surfase" → "surface"
+31. "ful" → "full"
+32. "dangling" → added missing period
+33. "JINGEL" → "jingle"
+34. "paradyse" → "paradise"
+35. "figur" → "figure"
+36. "gaurd" → "guard"
+37. "sumthing" → "something"
+38. "mor" → "more"
+39. "hudeld" → "huddled"
+40. "togethar" → "together"
+41. "there" → "their"
+42. "happan" → "happen"
+43. "amazeing" → "amazing"
+
+### Grammar and Syntax Errors
+1. Inconsistent verb tenses throughout the story
+2. Improper use of articles (a/an)
+3. Missing punctuation
+4. Lack of subject-verb agreement
+5. Incorrect capitalization
+
+### Style and Formatting Recommendations
+1. Use standard capitalization for proper nouns
+2. Maintain consistent verb tense (past tense recommended)
+3. Use proper punctuation
+4. Avoid excessive use of exclamation points
+5. Use standard spelling for all words
+
+## Factuality and Logical Consistency
+- The story is a fictional narrative about three kittens, so traditional factual constraints do not strictly apply
+- The narrative maintains internal logical consistency
+- The cliffhanger ending leaves room for imagination
+
+## Style Adherence
+### APA Formatting Guidelines
+- Title should be centered and in title case
+- Use 12-point Times New Roman font (not applicable in markdown)
+- Double-spacing recommended (not applicable in markdown)
+- 1-inch margins (not applicable in markdown)
+
+### Recommendations for Improvement
+1. Proofread and correct all spelling errors
+2. Maintain consistent grammar and syntax
+3. Use standard English spelling
+4. Add more descriptive language
+5. Develop a more structured narrative arc
+
+## Overall Assessment
+**Writing Quality**: Needs Significant Improvement
+**Creativity**: Excellent
+**Potential**: High
+
+### Suggested Revision
+Revise the text to correct spelling, grammar, and syntax while preserving the original creative narrative and imaginative elements.

{fast_agent_mcp-0.1.12/src/mcp_agent/resources → fast_agent_mcp-0.2.0}/examples/workflows/human_input.py

@@ -3,6 +3,7 @@ Agent which demonstrates Human Input tool
 """
 
 import asyncio
+
 from mcp_agent.core.fastagent import FastAgent
 
 # Create the application
@@ -14,11 +15,11 @@ fast = FastAgent("Human Input")
     instruction="An AI agent that assists with basic tasks. Request Human Input when needed.",
     human_input=True,
 )
-async def main():
+async def main() -> None:
     async with fast.run() as agent:
         # this usually causes the LLM to request the Human Input Tool
         await agent("print the next number in the sequence")
-        await agent.prompt(default="STOP")
+        await agent.prompt(default_prompt="STOP")
 
 
 if __name__ == "__main__":

{fast_agent_mcp-0.1.12/src/mcp_agent/resources → fast_agent_mcp-0.2.0}/examples/workflows/orchestrator.py

@@ -3,6 +3,7 @@ This demonstrates creating multiple agents and an orchestrator to coordinate the
 """
 
 import asyncio
+
 from mcp_agent.core.fastagent import FastAgent
 
 # Create the application
@@ -45,28 +46,23 @@ fast = FastAgent("Orchestrator-Workers")
 @fast.orchestrator(
     name="orchestrate",
     agents=["finder", "writer", "proofreader"],
-    plan_type="iterative",
+    plan_type="full",
 )
-async def main():
+async def main() -> None:
     async with fast.run() as agent:
-        await agent()
         await agent.author(
             "write a 250 word short story about kittens discovering a castle, and save it to short_story.md"
         )
 
         # The orchestrator can be used just like any other agent
-        task = (
-            """Load the student's short story from short_story.md, 
+        task = """Load the student's short story from short_story.md, 
         and generate a report with feedback across proofreading, 
         factuality/logical consistency and style adherence. Use the style rules from 
         https://apastyle.apa.org/learn/quick-guide-on-formatting and 
         https://apastyle.apa.org/learn/quick-guide-on-references.
-        Write the graded report to graded_report.md in the same directory as short_story.md""",
-        )
+        Write the graded report to graded_report.md in the same directory as short_story.md"""
 
-        # Send the task
         await agent.orchestrate(task)
-        await agent()
 
 
 if __name__ == "__main__":

{fast_agent_mcp-0.1.12/src/mcp_agent/resources → fast_agent_mcp-0.2.0}/examples/workflows/parallel.py

@@ -3,33 +3,15 @@ Parallel Workflow showing Fan Out and Fan In agents, using different models
 """
 
 import asyncio
+from pathlib import Path
+
 from mcp_agent.core.fastagent import FastAgent
+from mcp_agent.core.prompt import Prompt
 
 # Create the application
 fast = FastAgent(
     "Parallel Workflow",
 )
-SHORT_STORY = """
-The Battle of Glimmerwood
-
-In the heart of Glimmerwood, a mystical forest knowed for its radiant trees, a small village thrived. 
-The villagers, who were live peacefully, shared their home with the forest's magical creatures, 
-especially the Glimmerfoxes whose fur shimmer like moonlight.
-
-One fateful evening, the peace was shaterred when the infamous Dark Marauders attack. 
-Lead by the cunning Captain Thorn, the bandits aim to steal the precious Glimmerstones which was believed to grant immortality.
-
-Amidst the choas, a young girl named Elara stood her ground, she rallied the villagers and devised a clever plan.
-Using the forests natural defenses they lured the marauders into a trap. 
-As the bandits aproached the village square, a herd of Glimmerfoxes emerged, blinding them with their dazzling light, 
-the villagers seized the opportunity to captured the invaders.
-
-Elara's bravery was celebrated and she was hailed as the "Guardian of Glimmerwood". 
-The Glimmerstones were secured in a hidden grove protected by an ancient spell.
-
-However, not all was as it seemed. The Glimmerstones true power was never confirm, 
-and whispers of a hidden agenda linger among the villagers.
-"""
 
 
 @fast.agent(
@@ -65,14 +47,12 @@ and whispers of a hidden agenda linger among the villagers.
     fan_in="grader",
     name="parallel",
 )
-async def main():
-    # Use the app's context manager
+async def main() -> None:
     async with fast.run() as agent:
-        await agent.parallel(f"student short story submission: {SHORT_STORY}")
-
-        # follow-on prompt to task agent
-        await agent.style_enforcer.prompt(default_prompt="STOP")
+        await agent.parallel.send(
+            Prompt.user("Student short story submission", Path("short_story.txt"))
+        )
 
 
 if __name__ == "__main__":
-    asyncio.run(main())
+    asyncio.run(main())  # type: ignore

{fast_agent_mcp-0.1.12/src/mcp_agent/resources → fast_agent_mcp-0.2.0}/examples/workflows/router.py

@@ -6,6 +6,7 @@ Demonstrates router's ability to either:
 """
 
 import asyncio
+
 from mcp_agent.core.fastagent import FastAgent
 
 # Create the application
@@ -43,7 +44,7 @@ SAMPLE_REQUESTS = [
     model="sonnet",
     agents=["code_expert", "general_assistant", "fetcher"],
 )
-async def main():
+async def main() -> None:
     async with fast.run() as agent:
         for request in SAMPLE_REQUESTS:
             await agent.route(request)

fast_agent_mcp-0.2.0/examples/workflows/short_story.md

@@ -0,0 +1,13 @@
+The Kittens Castle Adventuer
+
+One sunny day, three lil kittens name Whiskers, Socks, and Mittens was walkin threw a mystirus forrest. They hadnt never seen such a big forrest before! The trees was tall an spooky, an the ground was coverd in moss an stikks.
+
+Suddenlee, thru the trees, they sawd somthing HUUUUGE! It was a castell, but not just eny castell. This castell was made of sparkling chese an glittery windos. The turrits was so high they tuch the clowds, an the doars was big enuff for a elefant to walk threw!
+
+"Lookk!" sed Whiskers, his tale all poofy wit exsitement. "We fowned a castell!" Socks meowed loudly an jumped up an down. Mittens, who was the smallist kitten, just stared wit her big rond eyes.
+
+They climed up the cheesy walls, slip-slidin on the smoth surfase. Inside, they discoverd rooms ful of soft pillows an dangling strings an shiny things that went JINGEL when they tuch them. It was like a kitten paradyse!
+
+But then, a big shadowy figur apeared... was it the castell gaurd? Or sumthing mor mystirus? The kittens hudeld togethar, there lil hearts beating fast. What wud happan next in there amazeing adventuer?
+
+THE END??

fast_agent_mcp-0.2.0/examples/workflows/short_story.txt

@@ -0,0 +1,19 @@
+The Battle of Glimmerwood
+
+In the heart of Glimmerwood, a mystical forest knowed for its radiant trees, a small village thrived. 
+The villagers, who were live peacefully, shared their home with the forest's magical creatures, 
+especially the Glimmerfoxes whose fur shimmer like moonlight.
+
+One fateful evening, the peace was shaterred when the infamous Dark Marauders attack. 
+Lead by the cunning Captain Thorn, the bandits aim to steal the precious Glimmerstones which was believed to grant immortality.
+
+Amidst the choas, a young girl named Elara stood her ground, she rallied the villagers and devised a clever plan.
+Using the forests natural defenses they lured the marauders into a trap. 
+As the bandits aproached the village square, a herd of Glimmerfoxes emerged, blinding them with their dazzling light, 
+the villagers seized the opportunity to captured the invaders.
+
+Elara's bravery was celebrated and she was hailed as the "Guardian of Glimmerwood". 
+The Glimmerstones were secured in a hidden grove protected by an ancient spell.
+
+However, not all was as it seemed. The Glimmerstones true power was never confirm, 
+and whispers of a hidden agenda linger among the villagers.

{fast_agent_mcp-0.1.12 → fast_agent_mcp-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fast-agent-mcp"
-version = "0.1.12"
+version = "0.2.0"
 description = "Define, Prompt and Test MCP enabled Agents and Workflows"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -16,7 +16,7 @@ classifiers = [
 requires-python = ">=3.10"
 dependencies = [
     "fastapi>=0.115.6",
-    "mcp>=1.5.0",
+    "mcp==1.6.0",
     "opentelemetry-distro>=0.50b0",
     "opentelemetry-exporter-otlp-proto-http>=1.29.0",
     "pydantic-settings>=2.7.0",
@@ -39,9 +39,6 @@ temporal = [
 openai = [
     "openai>=1.58.1",
 ]
-cohere = [
-    "cohere>=5.13.4",
-]
 dev = [
     "anthropic>=0.42.0",
     "pre-commit>=4.0.1",
@@ -51,6 +48,7 @@ dev = [
     "tomli>=2.2.1",
     "pytest>=7.4.0",
     "pytest-asyncio>=0.21.1",
+    "pytest-cov",
 ]
 
 [build-system]
@@ -66,10 +64,14 @@ include = [
     "src/mcp_agent/**/*.yaml",
     "src/mcp_agent/**/*.yml",
     "src/mcp_agent/**/*.csv",
-    "src/mcp_agent/resources/**/*.py",
-    "src/mcp_agent/resources/**/*.yaml",
-    "src/mcp_agent/resources/**/*.yml",
-    "src/mcp_agent/resources/**/*.csv",
+    "examples/**/*.py",
+    "examples/**/*.yaml",
+    "examples/**/*.yml",
+    "examples/**/*.txt",
+    "examples/**/*.csv",
+    "examples/**/*.md",
+    "examples/**/*.css",
+    "examples/**/mount-point/*.csv",
 ]
 
 [tool.pytest.ini_options]
@@ -103,12 +105,21 @@ silsila = "mcp_agent.cli.__main__:app"
 prompt-server = "mcp_agent.mcp.prompts.__main__:main"
 
 [tool.setuptools.package-data]
-mcp_agent = [
-    "data/*.json",
-    "resources/examples/**/*.py",
-    "resources/examples/**/*.yaml",
-    "resources/examples/**/*.yml",
-    "resources/examples/**/*.csv",
-    "resources/examples/**/mount-point/*.csv"
+mcp_agent = []
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "F",   # pyflakes
+    "I",   # isort
+    "TCH"  # type checking
 ]
+ignore=["E501"]
 
+# More lenient settings for existing code
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["ANN"]  # Don't require type annotations in tests

fast_agent_mcp-0.2.0/src/mcp_agent/__init__.py

@@ -0,0 +1,75 @@
+"""fast-agent - (fast-agent-mcp) An MCP native agent application framework"""
+
+# Import important MCP types
+from mcp.types import (
+    CallToolResult,
+    EmbeddedResource,
+    GetPromptResult,
+    ImageContent,
+    Prompt,
+    PromptMessage,
+    ReadResourceResult,
+    Role,
+    TextContent,
+    Tool,
+)
+
+# Core agent components
+from mcp_agent.agents.agent import Agent, AgentConfig
+from mcp_agent.core.direct_agent_app import DirectAgentApp
+
+# Workflow decorators
+from mcp_agent.core.direct_decorators import (
+    agent,
+    chain,
+    evaluator_optimizer,
+    orchestrator,
+    parallel,
+    router,
+)
+
+# FastAgent components
+from mcp_agent.core.fastagent import FastAgent
+
+# Request configuration
+from mcp_agent.core.request_params import RequestParams
+
+# Core protocol interfaces
+from mcp_agent.mcp.interfaces import AgentProtocol, AugmentedLLMProtocol
+from mcp_agent.mcp.mcp_aggregator import MCPAggregator, MCPCompoundServer
+from mcp_agent.mcp.prompt_message_multipart import PromptMessageMultipart
+
+__all__ = [
+    # MCP types
+    "Prompt",
+    "Tool",
+    "CallToolResult",
+    "TextContent",
+    "ImageContent",
+    "PromptMessage",
+    "GetPromptResult",
+    "ReadResourceResult",
+    "EmbeddedResource",
+    "Role",
+    # Core protocols
+    "AgentProtocol",
+    "AugmentedLLMProtocol",
+    # Core agent components
+    "Agent",
+    "AgentConfig",
+    "MCPAggregator",
+    "MCPCompoundServer",
+    "PromptMessageMultipart",
+    # FastAgent components
+    "FastAgent",
+    "DirectAgentApp",
+    # Workflow decorators
+    "agent",
+    "orchestrator",
+    "router",
+    "chain",
+    "parallel",
+    "evaluator_optimizer",
+    # Request configuration
+    "RequestParams",
+]