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

{fast_agent_mcp-0.1.13 → 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.13 → fast_agent_mcp-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.1.13
+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.13/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")

{fast_agent_mcp-0.1.13/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)")

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

@@ -46,7 +46,7 @@ async def main() -> None:
         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.13/src/mcp_agent/resources → fast_agent_mcp-0.2.0}/examples/researcher/researcher-imp.py

@@ -182,7 +182,7 @@ async def main() -> None:
         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")
+        await agent.prompt("Researcher", default_prompt="STOP")
 
 
 if __name__ == "__main__":

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

@@ -31,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.13/src/mcp_agent/resources → fast_agent_mcp-0.2.0}/examples/workflows/chaining.py

@@ -25,16 +25,7 @@ fast = FastAgent("Agent Chaining")
 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.13/src/mcp_agent/resources → fast_agent_mcp-0.2.0}/examples/workflows/evaluator.py

@@ -72,8 +72,6 @@ async def main() -> None:
             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.13/src/mcp_agent/resources → fast_agent_mcp-0.2.0}/examples/workflows/human_input.py

@@ -19,7 +19,7 @@ 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.13/src/mcp_agent/resources → fast_agent_mcp-0.2.0}/examples/workflows/orchestrator.py

@@ -46,28 +46,23 @@ fast = FastAgent("Orchestrator-Workers")
 @fast.orchestrator(
     name="orchestrate",
     agents=["finder", "writer", "proofreader"],
-    plan_type="iterative",
+    plan_type="full",
 )
 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.13/src/mcp_agent/resources → fast_agent_mcp-0.2.0}/examples/workflows/parallel.py

@@ -3,34 +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(
@@ -67,13 +48,11 @@ and whispers of a hidden agenda linger among the villagers.
     name="parallel",
 )
 async def main() -> None:
-    # Use the app's context manager
     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.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.13 → fast_agent_mcp-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fast-agent-mcp"
-version = "0.1.13"
+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,17 +105,10 @@ 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 = 160
+line-length = 100
 target-version = "py310"
 
 [tool.ruff.lint]

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",
+]

fast_agent_mcp-0.2.0/src/mcp_agent/agents/agent.py

@@ -0,0 +1,96 @@
+"""
+Agent implementation using the clean BaseAgent adapter.
+
+This provides a streamlined implementation that adheres to AgentProtocol
+while delegating LLM operations to an attached AugmentedLLMProtocol instance.
+"""
+
+from typing import TYPE_CHECKING, Any, Callable, Dict, List, Optional, TypeVar
+
+from mcp_agent.agents.base_agent import BaseAgent
+from mcp_agent.core.agent_types import AgentConfig
+from mcp_agent.core.interactive_prompt import InteractivePrompt
+from mcp_agent.human_input.types import HumanInputCallback
+from mcp_agent.logging.logger import get_logger
+from mcp_agent.mcp.interfaces import AugmentedLLMProtocol
+
+if TYPE_CHECKING:
+    from mcp_agent.context import Context
+
+logger = get_logger(__name__)
+
+# Define a TypeVar for AugmentedLLM and its subclasses
+LLM = TypeVar("LLM", bound=AugmentedLLMProtocol)
+
+
+class Agent(BaseAgent):
+    """
+    An Agent is an entity that has access to a set of MCP servers and can interact with them.
+    Each agent should have a purpose defined by its instruction.
+
+    This implementation provides a clean adapter that adheres to AgentProtocol
+    while delegating LLM operations to an attached AugmentedLLMProtocol instance.
+    """
+
+    def __init__(
+        self,
+        config: AgentConfig,  # Can be AgentConfig or backward compatible str name
+        functions: Optional[List[Callable]] = None,
+        connection_persistence: bool = True,
+        human_input_callback: Optional[HumanInputCallback] = None,
+        context: Optional["Context"] = None,
+        **kwargs: Dict[str, Any],
+    ) -> None:
+        # Initialize with BaseAgent constructor
+        super().__init__(
+            config=config,
+            functions=functions,
+            connection_persistence=connection_persistence,
+            human_input_callback=human_input_callback,
+            context=context,
+            **kwargs,
+        )
+
+    async def prompt(self, default_prompt: str = "", agent_name: Optional[str] = None) -> str:
+        """
+        Start an interactive prompt session with this agent.
+
+        Args:
+            default: Default message to use when user presses enter
+            agent_name: Ignored for single agents, included for API compatibility
+
+        Returns:
+            The result of the interactive session
+        """
+        # Use the agent name as a string - ensure it's not the object itself
+        agent_name_str = str(self.name)
+
+        # Create agent_types dictionary with just this agent
+        agent_types = {agent_name_str: getattr(self.config, "agent_type", "Agent")}
+
+        # Create the interactive prompt
+        prompt = InteractivePrompt(agent_types=agent_types)
+
+        # Define wrapper for send function
+        async def send_wrapper(message, agent_name):
+            return await self.send(message)
+
+        # Define wrapper for apply_prompt function
+        async def apply_prompt_wrapper(prompt_name, args, agent_name):
+            # Just apply the prompt directly
+            return await self.apply_prompt(prompt_name, args)
+
+        # Define wrapper for list_prompts function
+        async def list_prompts_wrapper(agent_name):
+            # Always call list_prompts on this agent regardless of agent_name
+            return await self.list_prompts()
+
+        # Start the prompt loop with just this agent
+        return await prompt.prompt_loop(
+            send_func=send_wrapper,
+            default_agent=agent_name_str,
+            available_agents=[agent_name_str],  # Only this agent
+            apply_prompt_func=apply_prompt_wrapper,
+            list_prompts_func=list_prompts_wrapper,
+            default=default_prompt,
+        )