fast-agent-mcp 0.2.16__tar.gz → 0.2.18__tar.gz

{fast_agent_mcp-0.2.16 → fast_agent_mcp-0.2.18}/.gitignore

@@ -194,3 +194,4 @@ tests/e2e/workflow/weather_location.txt
 tests/integration/prompt-state/multipart.json
 tests/integration/prompt-state/history.json
 !tests/integration/api/fastagent.secrets.yaml
+fastagent.jsonl

{fast_agent_mcp-0.2.16 → fast_agent_mcp-0.2.18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.2.16
+Version: 0.2.18
 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
@@ -237,8 +237,6 @@ Requires-Dist: ruff>=0.8.4; extra == 'dev'
 Requires-Dist: tomli>=2.2.1; extra == 'dev'
 Provides-Extra: openai
 Requires-Dist: openai>=1.58.1; extra == 'openai'
-Provides-Extra: temporal
-Requires-Dist: temporalio>=1.8.0; extra == 'temporal'
 Description-Content-Type: text/markdown
 
 <p align="center">
@@ -255,13 +253,14 @@ Description-Content-Type: text/markdown
 > [!TIP]
 > Documentation site is in production here : https://fast-agent.ai. Feel free to feed back what's helpful and what's not. llms.txt link is here: https://fast-agent.ai/llms.txt
 
-**`fast-agent`** enables you to create and interact with sophisticated Agents and Workflows in minutes. It is the first framework with complete, end-to-end tested MCP Feature support including Sampling. Both Anthropic (Haiku, Sonnet, Opus) and OpenAI models (gpt-4o family, o1/o3 family) are supported.
+**`fast-agent`** enables you to create and interact with sophisticated Agents and Workflows in minutes. It is the first framework with complete, end-to-end tested MCP Feature support including Sampling. Both Anthropic (Haiku, Sonnet, Opus) and OpenAI models (gpt-4o/gpt-4.1 family, o1/o3 family) are supported.
 
 The simple declarative syntax lets you concentrate on composing your Prompts and MCP Servers to [build effective agents](https://www.anthropic.com/research/building-effective-agents).
 
 `fast-agent` is multi-modal, supporting Images and PDFs for both Anthropic and OpenAI endpoints via Prompts, Resources and MCP Tool Call results. The inclusion of passthrough and playback LLMs enable rapid development and test of Python glue-code for your applications.
 
-> [!TIP] > `fast-agent` is now MCP Native! Coming Soon - Full Documentation Site and Further MCP Examples.
+> [!TIP]
+> `fast-agent` is now MCP Native! Coming Soon - Full Documentation Site and Further MCP Examples.
 
 ### Agent Application Development
 
@@ -313,7 +312,7 @@ Or start an interactive chat with the Agent:
 
 ```python
 async with fast.run() as agent:
-  await agent()
+  await agent.interactive()
 ```
 
 Here is the complete `sizer.py` Agent application, with boilerplate code:
@@ -330,7 +329,7 @@ fast = FastAgent("Agent Example")
 )
 async def main():
   async with fast.run() as agent:
-    await agent()
+    await agent.interactive()
 
 if __name__ == "__main__":
     asyncio.run(main())

{fast_agent_mcp-0.2.16 → fast_agent_mcp-0.2.18}/README.md

@@ -12,13 +12,14 @@
 > [!TIP]
 > Documentation site is in production here : https://fast-agent.ai. Feel free to feed back what's helpful and what's not. llms.txt link is here: https://fast-agent.ai/llms.txt
 
-**`fast-agent`** enables you to create and interact with sophisticated Agents and Workflows in minutes. It is the first framework with complete, end-to-end tested MCP Feature support including Sampling. Both Anthropic (Haiku, Sonnet, Opus) and OpenAI models (gpt-4o family, o1/o3 family) are supported.
+**`fast-agent`** enables you to create and interact with sophisticated Agents and Workflows in minutes. It is the first framework with complete, end-to-end tested MCP Feature support including Sampling. Both Anthropic (Haiku, Sonnet, Opus) and OpenAI models (gpt-4o/gpt-4.1 family, o1/o3 family) are supported.
 
 The simple declarative syntax lets you concentrate on composing your Prompts and MCP Servers to [build effective agents](https://www.anthropic.com/research/building-effective-agents).
 
 `fast-agent` is multi-modal, supporting Images and PDFs for both Anthropic and OpenAI endpoints via Prompts, Resources and MCP Tool Call results. The inclusion of passthrough and playback LLMs enable rapid development and test of Python glue-code for your applications.
 
-> [!TIP] > `fast-agent` is now MCP Native! Coming Soon - Full Documentation Site and Further MCP Examples.
+> [!TIP]
+> `fast-agent` is now MCP Native! Coming Soon - Full Documentation Site and Further MCP Examples.
 
 ### Agent Application Development
 
@@ -70,7 +71,7 @@ Or start an interactive chat with the Agent:
 
 ```python
 async with fast.run() as agent:
-  await agent()
+  await agent.interactive()
 ```
 
 Here is the complete `sizer.py` Agent application, with boilerplate code:
@@ -87,7 +88,7 @@ fast = FastAgent("Agent Example")
 )
 async def main():
   async with fast.run() as agent:
-    await agent()
+    await agent.interactive()
 
 if __name__ == "__main__":
     asyncio.run(main())

{fast_agent_mcp-0.2.16/src/mcp_agent/resources → fast_agent_mcp-0.2.18}/examples/data-analysis/analysis-campaign.py

@@ -33,7 +33,7 @@ Extract key insights that would be compelling for a social media campaign.
      - Extracted compelling insights suitable for social media promotion
     """,
     request_params=RequestParams(maxTokens=8192),
-    model="gpt-4o",
+    model="gpt-4.1",
 )
 @fast.evaluator_optimizer(
     "analysis_tool",
@@ -55,7 +55,7 @@ Extract key insights that would be compelling for a social media campaign.
     """,
     servers=["fetch", "brave"],  # Using the fetch MCP server for Brave search
     request_params=RequestParams(temperature=0.3),
-    model="gpt-4o",
+    model="gpt-4.1",
 )
 # Social media content generator
 @fast.agent(

{fast_agent_mcp-0.2.16 → fast_agent_mcp-0.2.18}/examples/mcp/state-transfer/fastagent.config.yaml

@@ -5,7 +5,7 @@
 # Check here for current details: https://fast-agent.ai/models/
 
 # set the default model for fast-agent below:
-default_model: gpt-4o
+default_model: gpt-4.1
 
 # Logging and Console Configuration:
 logger:

fast_agent_mcp-0.2.18/examples/mcp/vision-examples/example1.py

@@ -0,0 +1,27 @@
+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("fast-agent example")
+
+
+# Define the agent
+@fast.agent(instruction="You are a helpful AI Agent", servers=["filesystem"])
+async def main():
+    # use the --model command line switch or agent arguments to change model
+    async with fast.run() as agent:
+        await agent.default.generate(
+            [
+                Prompt.user(
+                    Path("cat.png"), "Write a report on the content of the image to 'report.md'"
+                )
+            ]
+        )
+        await agent.interactive()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

fast_agent_mcp-0.2.18/examples/mcp/vision-examples/example2.py

@@ -0,0 +1,18 @@
+import asyncio
+
+from mcp_agent.core.fastagent import FastAgent
+
+# Create the application
+fast = FastAgent("fast-agent example")
+
+
+# Define the agent
+@fast.agent(instruction="You are a helpful AI Agent", servers=["filesystem"])
+async def main():
+    # use the --model command line switch or agent arguments to change model
+    async with fast.run() as agent:
+        await agent.interactive()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

fast_agent_mcp-0.2.18/examples/mcp/vision-examples/example3.py

@@ -0,0 +1,20 @@
+import asyncio
+
+from mcp_agent.core.fastagent import FastAgent
+
+# Create the application
+fast = FastAgent("fast-agent example")
+
+
+# Define the agent
+@fast.agent(instruction="You are a helpful AI Agent", servers=["webcam", "hfspace"])
+async def main():
+    async with fast.run() as agent:
+        await agent.interactive(
+            default_prompt="take an image with the webcam, describe it to flux to "
+            "reproduce it and then judge the quality of the result"
+        )
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

fast_agent_mcp-0.2.18/examples/mcp/vision-examples/fastagent.config.yaml

@@ -0,0 +1,47 @@
+# FastAgent Configuration File
+
+# Default Model Configuration:
+# 
+# Takes format:
+#   <provider>.<model_string>.<reasoning_effort?> (e.g. anthropic.claude-3-5-sonnet-20241022 or openai.o3-mini.low)
+# Accepts aliases for Anthropic Models: haiku, haiku3, sonnet, sonnet35, opus, opus3
+# and OpenAI Models: gpt-4.1, gpt-4.1-mini, o1, o1-mini, o3-mini
+#
+# If not specified, defaults to "haiku". 
+# Can be overriden with a command line switch --model=<model>, or within the Agent constructor.
+
+default_model: haiku
+
+# Logging and Console Configuration:
+logger:
+    # level: "debug" | "info" | "warning" | "error"
+    # type: "none" | "console" | "file" | "http"
+    # path: "/path/to/logfile.jsonl"
+
+    
+    # Switch the progress display on or off
+    progress_display: true
+
+    # Show chat User/Assistant messages on the console
+    show_chat: true
+    # Show tool calls on the console
+    show_tools: true
+    # Truncate long tool responses on the console 
+    truncate_tools: true
+
+# MCP Servers
+mcp:
+    servers:
+        fetch:
+            command: "uvx"
+            args: ["mcp-server-fetch"]
+        filesystem:
+            command: "npx"
+            args: ["-y", "@modelcontextprotocol/server-filesystem", "."]
+        webcam: 
+            command: "npx"
+            args: ["-y","@llmindset/mcp-webcam"]
+        hfspace:
+            command: "npx"
+            args: ["-y","@llmindset/mcp-hfspace"]
+

{fast_agent_mcp-0.2.16/src/mcp_agent/resources → fast_agent_mcp-0.2.18}/examples/researcher/fastagent.config.yaml

@@ -4,7 +4,6 @@
 #
 #
 
-execution_engine: asyncio
 logger:
   type: console
   level: error
@@ -53,14 +52,10 @@ mcp:
       args: ["mcp-server-fetch"]
     sequential:
       command: "npx"
-      args: ["-y","@modelcontextprotocol/server-sequential-thinking"]
-
+      args: ["-y", "@modelcontextprotocol/server-sequential-thinking"]
 #    webmcp:
 #      command: "node"
 #      args: ["/home/ssmith/.webmcp/server.cjs"]
 #      env:
 #         WEBMCP_SERVER_TOKEN: 96e22896d8143fc1d61fec09208fc5ed
 
-
-
-

{fast_agent_mcp-0.2.16/src/mcp_agent/resources → fast_agent_mcp-0.2.18}/examples/workflows/evaluator.py

@@ -40,7 +40,7 @@ fast = FastAgent("Evaluator-Optimizer")
     Summarize your evaluation as a structured response with:
     - Overall quality rating.
     - Specific feedback and areas for improvement.""",
-    model="gpt-4o",
+    model="gpt-4.1",
 )
 # Define the evaluator-optimizer workflow
 @fast.evaluator_optimizer(

{fast_agent_mcp-0.2.16 → fast_agent_mcp-0.2.18}/examples/workflows/fastagent.config.yaml

@@ -3,7 +3,6 @@
 #
 #
 
-execution_engine: asyncio
 logger:
   type: file
   level: error

{fast_agent_mcp-0.2.16/src/mcp_agent/resources → fast_agent_mcp-0.2.18}/examples/workflows/orchestrator.py

@@ -13,7 +13,7 @@ fast = FastAgent("Orchestrator-Workers")
 @fast.agent(
     "author",
     instruction="""You are to role play a poorly skilled writer, 
-    who makes frequent grammar, punctuations and spelling errors. You enjoy
+    who makes frequent grammar, punctuation and spelling errors. You enjoy
     writing short stories, but the narrative doesn't always make sense""",
     servers=["filesystem"],
 )
@@ -25,7 +25,7 @@ fast = FastAgent("Orchestrator-Workers")
             the closest match to a user's request, make the appropriate tool calls, 
             and return the URI and CONTENTS of the closest match.""",
     servers=["fetch", "filesystem"],
-    model="gpt-4o",
+    model="gpt-4.1",
 )
 @fast.agent(
     name="writer",
@@ -40,19 +40,17 @@ fast = FastAgent("Orchestrator-Workers")
             Identify any awkward phrasing or structural issues that could improve clarity. 
             Provide detailed feedback on corrections.""",
     servers=["fetch"],
-    model="gpt-4o",
+    model="gpt-4.1",
 )
 # Define the orchestrator to coordinate the other agents
 @fast.orchestrator(
-    name="orchestrate",
-    agents=["finder", "writer", "proofreader"],
-    plan_type="full",
+    name="orchestrate", agents=["finder", "writer", "proofreader"], plan_type="full", model="sonnet"
 )
 async def main() -> None:
     async with fast.run() as agent:
-        await agent.author(
-            "write a 250 word short story about kittens discovering a castle, and save it to short_story.md"
-        )
+        # 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, 

{fast_agent_mcp-0.2.16/src/mcp_agent/resources → fast_agent_mcp-0.2.18}/examples/workflows/parallel.py

@@ -25,7 +25,7 @@ fast = FastAgent(
     instruction="""Verify the factual consistency within the story. Identify any contradictions,
     logical inconsistencies, or inaccuracies in the plot, character actions, or setting. 
     Highlight potential issues with reasoning or coherence.""",
-    model="gpt-4o",
+    model="gpt-4.1",
 )
 @fast.agent(
     name="style_enforcer",

{fast_agent_mcp-0.2.16 → fast_agent_mcp-0.2.18}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fast-agent-mcp"
-version = "0.2.16"
+version = "0.2.18"
 description = "Define, Prompt and Test MCP enabled Agents and Workflows"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -34,9 +34,6 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
-temporal = [
-    "temporalio>=1.8.0",
-]
 openai = [
     "openai>=1.58.1",
 ]

{fast_agent_mcp-0.2.16 → fast_agent_mcp-0.2.18}/src/mcp_agent/agents/base_agent.py

@@ -20,6 +20,7 @@ from typing import (
     Union,
 )
 
+from a2a_types.types import AgentCapabilities, AgentCard, AgentSkill
 from mcp.types import (
     CallToolResult,
     EmbeddedResource,
@@ -58,6 +59,11 @@ if TYPE_CHECKING:
     from mcp_agent.context import Context
 
 
+DEFAULT_CAPABILITIES = AgentCapabilities(
+    streaming=False, pushNotifications=False, stateTransitionHistory=False
+)
+
+
 class BaseAgent(MCPAggregator, AgentProtocol):
     """
     A base Agent class that implements the AgentProtocol interface.
@@ -586,7 +592,7 @@ class BaseAgent(MCPAggregator, AgentProtocol):
 
     async def structured(
         self,
-        prompt: List[PromptMessageMultipart],
+        multipart_messages: List[PromptMessageMultipart],
         model: Type[ModelT],
         request_params: RequestParams | None = None,
     ) -> Tuple[ModelT | None, PromptMessageMultipart]:
@@ -603,7 +609,7 @@ class BaseAgent(MCPAggregator, AgentProtocol):
             An instance of the specified model, or None if coercion fails
         """
         assert self._llm
-        return await self._llm.structured(prompt, model, request_params)
+        return await self._llm.structured(multipart_messages, model, request_params)
 
     async def apply_prompt_messages(
         self, prompts: List[PromptMessageMultipart], request_params: RequestParams | None = None
@@ -626,13 +632,51 @@ class BaseAgent(MCPAggregator, AgentProtocol):
     def agent_type(self) -> AgentType:
         """
         Return the type of this agent.
+        """
+        return AgentType.BASIC
+
+    async def agent_card(self) -> AgentCard:
+        """
+        Return an A2A card describing this Agent
+        """
 
-        This is used for display purposes in the interactive prompt and other UI elements.
+        skills: List[AgentSkill] = []
+        tools: ListToolsResult = await self.list_tools()
+        for tool in tools.tools:
+            skills.append(await self.convert(tool))
 
-        Returns:
-            String representing the agent type
+        return AgentCard(
+            name=self.name,
+            description=self.instruction,
+            url=f"fast-agent://agents/{self.name}/",
+            version="0.1",
+            capabilities=DEFAULT_CAPABILITIES,
+            defaultInputModes=["text/plain"],
+            defaultOutputModes=["text/plain"],
+            provider=None,
+            documentationUrl=None,
+            authentication=None,
+            skills=skills,
+        )
+
+    async def convert(self, tool: Tool) -> AgentSkill:
         """
-        return AgentType.BASIC
+        Convert a Tool to an AgentSkill.
+        """
+
+        _, tool_without_namespace = await self._parse_resource_name(tool.name, "tool")
+        return AgentSkill(
+            id=tool.name,
+            name=tool_without_namespace,
+            description=tool.description,
+            tags=["tool"],
+            examples=None,
+            inputModes=None,  # ["text/plain"],
+            # cover TextContent | ImageContent ->
+            # https://github.com/modelcontextprotocol/modelcontextprotocol/pull/223
+            # https://github.com/modelcontextprotocol/modelcontextprotocol/pull/93
+            outputModes=None,  # ,["text/plain", "image/*"],
+        )
 
     @property
     def message_history(self) -> List[PromptMessageMultipart]:

{fast_agent_mcp-0.2.16 → fast_agent_mcp-0.2.18}/src/mcp_agent/agents/workflow/orchestrator_agent.py

@@ -57,6 +57,7 @@ class OrchestratorAgent(BaseAgent):
         config: AgentConfig,
         agents: List[Agent],
         plan_type: Literal["full", "iterative"] = "full",
+        plan_iterations: int = 5,
         context: Optional[Any] = None,
         **kwargs,
     ) -> None:
@@ -83,7 +84,7 @@ class OrchestratorAgent(BaseAgent):
             agent_name = agent.name
             self.logger.info(f"Adding agent '{agent_name}' to orchestrator")
             self.agents[agent_name] = agent
-
+        self.plan_iterations = plan_iterations
         # For tracking state during execution
         self.plan_result: Optional[PlanResult] = None
 
@@ -186,8 +187,8 @@ class OrchestratorAgent(BaseAgent):
         """
         iterations = 0
         total_steps_executed = 0
-        max_iterations = request_params.max_iterations
-        max_steps = getattr(request_params, "max_steps", max_iterations * 5)
+        max_iterations = self.plan_iterations
+        max_steps = getattr(request_params, "max_steps", max_iterations * 3)
 
         # Initialize plan result
         plan_result = PlanResult(objective=objective, step_results=[])
@@ -414,7 +415,7 @@ class OrchestratorAgent(BaseAgent):
             plan_status = "Plan Status: Not Started"
 
         # Calculate iteration information
-        max_iterations = request_params.max_iterations
+        max_iterations = self.plan_iterations
         current_iteration = len(plan_result.step_results)
         current_iteration = min(current_iteration, max_iterations - 1)
         iterations_remaining = max(0, max_iterations - current_iteration - 1)
@@ -536,9 +537,7 @@ class OrchestratorAgent(BaseAgent):
             return ""
 
         # Get agent instruction or default description
-        instruction = (
-            agent.instruction if hasattr(agent, "instruction") else f"Agent '{agent_name}'"
-        )
+        instruction = agent.instruction if agent.instruction else f"Agent '{agent_name}'"
 
         # Format with XML tags
         return f'<fastagent:agent name="{agent_name}">{instruction}</fastagent:agent>'