fast-agent-mcp 0.3.5__tar.gz → 0.3.7__tar.gz

{fast_agent_mcp-0.3.5 → fast_agent_mcp-0.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.3.5
+Version: 0.3.7
 Summary: Define, Prompt and Test MCP enabled Agents and Workflows
 Author-email: Shaun Smith <fastagent@llmindset.co.uk>
 License:                                  Apache License
@@ -211,7 +211,7 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.13.5
 Requires-Dist: a2a-sdk>=0.3.0
 Requires-Dist: aiohttp>=3.11.13
-Requires-Dist: anthropic>=0.66.0
+Requires-Dist: anthropic>=0.68.0
 Requires-Dist: azure-identity>=1.14.0
 Requires-Dist: boto3>=1.35.0
 Requires-Dist: deprecated>=1.2.18
@@ -220,7 +220,7 @@ Requires-Dist: fastapi>=0.115.6
 Requires-Dist: google-genai>=1.33.0
 Requires-Dist: keyring>=24.3.1
 Requires-Dist: mcp==1.14.0
-Requires-Dist: openai>=1.106.1
+Requires-Dist: openai>=1.108.0
 Requires-Dist: opentelemetry-distro>=0.55b0
 Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.7.0
 Requires-Dist: opentelemetry-instrumentation-anthropic>=0.43.1; python_version >= '3.10' and python_version < '4.0'

{fast_agent_mcp-0.3.5/src/fast_agent/resources → fast_agent_mcp-0.3.7/examples}/setup/.gitignore

@@ -22,3 +22,9 @@ fastagent.jsonl
 # Editors (optional)
 .idea/
 .vscode/
+
+# Packaging metadata
+*.dist-info/
+*.egg-info/
+dist/
+build/

{fast_agent_mcp-0.3.5 → fast_agent_mcp-0.3.7}/examples/setup/agent.py

@@ -6,8 +6,15 @@ from fast_agent import FastAgent
 fast = FastAgent("fast-agent example")
 
 
+default_instruction = """You are a helpful AI Agent.
+
+{{serverInstructions}}
+
+The current date is {{currentDate}}."""
+
+
 # Define the agent
-@fast.agent(instruction="You are a helpful AI Agent")
+@fast.agent(instruction=default_instruction)
 async def main():
     # use the --model command line switch or agent arguments to change model
     async with fast.run() as agent:

{fast_agent_mcp-0.3.5 → fast_agent_mcp-0.3.7}/examples/setup/fastagent.config.yaml

@@ -7,10 +7,10 @@
 # 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".
+# If not specified, defaults to "gpt-5-mini.low".
 # Can be overriden with a command line switch --model=<model>, or within the Agent constructor.
 
-default_model: haiku
+default_model: gpt-5-mini.low
 # mcp-ui support: disabled, enabled or auto. "auto" opens the web browser on the asset automatically
 # mcp_ui_output_dir: ".fast-agent/ui"  # Where to write MCP-UI HTML files (relative to CWD if not absolute)
 # mcp_ui_mode: enabled

{fast_agent_mcp-0.3.5 → fast_agent_mcp-0.3.7}/examples/setup/pyproject.toml.tmpl

@@ -15,3 +15,9 @@ package = true
 [project.scripts]
 fast-agent-app = "agent:main"
 
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+py-modules = ["agent"]

{fast_agent_mcp-0.3.5 → fast_agent_mcp-0.3.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fast-agent-mcp"
-version = "0.3.5"
+version = "0.3.7"
 description = "Define, Prompt and Test MCP enabled Agents and Workflows"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -23,8 +23,8 @@ dependencies = [
     "pyyaml>=6.0.2",
     "rich>=14.1.0",
     "typer>=0.15.1",
-    "anthropic>=0.66.0",
-    "openai>=1.106.1",
+    "anthropic>=0.68.0",
+    "openai>=1.108.0",
     "azure-identity>=1.14.0",
     "boto3>=1.35.0",
     "prompt-toolkit>=3.0.51",

{fast_agent_mcp-0.3.5 → fast_agent_mcp-0.3.7}/src/fast_agent/__init__.py

@@ -27,8 +27,11 @@ from fast_agent.config import (
     XAISettings,
 )
 
+# Prompt helpers (safe - no heavy dependencies)
+from fast_agent.mcp.prompt import Prompt
+
 # Type definitions and enums (safe - no dependencies)
-from fast_agent.types import LlmStopReason, RequestParams
+from fast_agent.types import LlmStopReason, PromptMessageExtended, RequestParams
 
 
 def __getattr__(name: str):
@@ -91,6 +94,8 @@ def __getattr__(name: str):
 if TYPE_CHECKING:  # pragma: no cover - typing aid only
     # Provide a concrete import path for type checkers/IDEs
     from fast_agent.core.fastagent import FastAgent as FastAgent  # noqa: F401
+    from fast_agent.mcp.prompt import Prompt as Prompt  # noqa: F401
+    from fast_agent.types import PromptMessageExtended as PromptMessageExtended  # noqa: F401
 
 
 __all__ = [
@@ -127,6 +132,9 @@ __all__ = [
     # Type definitions and enums (eagerly loaded)
     "LlmStopReason",
     "RequestParams",
+    "PromptMessageExtended",
+    # Prompt helpers (eagerly loaded)
+    "Prompt",
     # Agents (lazy loaded)
     "LlmAgent",
     "LlmDecorator",

{fast_agent_mcp-0.3.5 → fast_agent_mcp-0.3.7}/src/fast_agent/agents/agent_types.py

@@ -3,7 +3,7 @@ Type definitions for agents and agent configurations.
 """
 
 from dataclasses import dataclass, field
-from enum import Enum
+from enum import StrEnum, auto
 from typing import Dict, List, Optional
 
 from mcp.client.session import ElicitationFnT
@@ -12,18 +12,18 @@ from mcp.client.session import ElicitationFnT
 from fast_agent.types import RequestParams
 
 
-class AgentType(Enum):
+class AgentType(StrEnum):
     """Enumeration of supported agent types."""
 
-    LLM = "llm"  # simple llm delegator
-    BASIC = "agent"
-    CUSTOM = "custom"
-    ORCHESTRATOR = "orchestrator"
-    PARALLEL = "parallel"
-    EVALUATOR_OPTIMIZER = "evaluator_optimizer"
-    ROUTER = "router"
-    CHAIN = "chain"
-    ITERATIVE_PLANNER = "iterative_planner"
+    LLM = auto()
+    BASIC = auto()
+    CUSTOM = auto()
+    ORCHESTRATOR = auto()
+    PARALLEL = auto()
+    EVALUATOR_OPTIMIZER = auto()
+    ROUTER = auto()
+    CHAIN = auto()
+    ITERATIVE_PLANNER = auto()
 
 
 @dataclass

{fast_agent_mcp-0.3.5 → fast_agent_mcp-0.3.7}/src/fast_agent/agents/llm_agent.py

@@ -81,66 +81,93 @@ class LlmAgent(LlmDecorator):
         """
 
         # Determine display content based on stop reason if not provided
-        if additional_message is None:
-            # Generate additional message based on stop reason
-            match message.stop_reason:
-                case LlmStopReason.END_TURN:
-                    # No additional message needed for normal end turn
-                    additional_message_text = None
-
-                case LlmStopReason.MAX_TOKENS:
-                    additional_message_text = Text(
+        additional_segments: List[Text] = []
+
+        # Generate additional message based on stop reason
+        match message.stop_reason:
+            case LlmStopReason.END_TURN:
+                pass
+
+            case LlmStopReason.MAX_TOKENS:
+                additional_segments.append(
+                    Text(
                         "\n\nMaximum output tokens reached - generation stopped.",
                         style="dim red italic",
                     )
+                )
 
-                case LlmStopReason.SAFETY:
-                    additional_message_text = Text(
-                        "\n\nContent filter activated - generation stopped.", style="dim red italic"
+            case LlmStopReason.SAFETY:
+                additional_segments.append(
+                    Text(
+                        "\n\nContent filter activated - generation stopped.",
+                        style="dim red italic",
                     )
+                )
 
-                case LlmStopReason.PAUSE:
-                    additional_message_text = Text(
-                        "\n\nLLM has requested a pause.", style="dim green italic"
-                    )
+            case LlmStopReason.PAUSE:
+                additional_segments.append(
+                    Text("\n\nLLM has requested a pause.", style="dim green italic")
+                )
 
-                case LlmStopReason.STOP_SEQUENCE:
-                    additional_message_text = Text(
-                        "\n\nStop Sequence activated - generation stopped.", style="dim red italic"
+            case LlmStopReason.STOP_SEQUENCE:
+                additional_segments.append(
+                    Text(
+                        "\n\nStop Sequence activated - generation stopped.",
+                        style="dim red italic",
                     )
+                )
 
-                case LlmStopReason.TOOL_USE:
-                    if None is message.last_text():
-                        additional_message_text = Text(
-                            "The assistant requested tool calls", style="dim green italic"
-                        )
-                    else:
-                        additional_message_text = None
+            case LlmStopReason.TOOL_USE:
+                if None is message.last_text():
+                    additional_segments.append(
+                        Text("The assistant requested tool calls", style="dim green italic")
+                    )
 
-                case _:
-                    if message.stop_reason:
-                        additional_message_text = Text(
+            case _:
+                if message.stop_reason:
+                    additional_segments.append(
+                        Text(
                             f"\n\nGeneration stopped for an unhandled reason ({message.stop_reason})",
                             style="dim red italic",
                         )
-                    else:
-                        additional_message_text = None
-        else:
-            # Use provided additional message
-            additional_message_text = (
-                additional_message if isinstance(additional_message, Text) else None
+                    )
+
+        if additional_message is not None:
+            additional_segments.append(
+                additional_message if isinstance(additional_message, Text) else Text(str(additional_message))
             )
 
+        additional_message_text = None
+        if additional_segments:
+            combined = Text()
+            for segment in additional_segments:
+                combined += segment
+            additional_message_text = combined
+
         message_text = message.last_text() or ""
 
         # Use provided name/model or fall back to defaults
         display_name = name if name is not None else self.name
         display_model = model if model is not None else (self.llm.model_name if self._llm else None)
 
+        # Convert highlight_items to highlight_index
+        highlight_index = None
+        if highlight_items and bottom_items:
+            if isinstance(highlight_items, str):
+                try:
+                    highlight_index = bottom_items.index(highlight_items)
+                except ValueError:
+                    pass
+            elif isinstance(highlight_items, list) and len(highlight_items) > 0:
+                try:
+                    highlight_index = bottom_items.index(highlight_items[0])
+                except ValueError:
+                    pass
+
         await self.display.show_assistant_message(
             message_text,
             bottom_items=bottom_items,
-            highlight_items=highlight_items,
+            highlight_index=highlight_index,
             max_item_length=max_item_length,
             name=display_name,
             model=display_model,
@@ -168,9 +195,13 @@ class LlmAgent(LlmDecorator):
 
         # TODO -- we should merge the request parameters here with the LLM defaults?
         # TODO - manage error catch, recovery, pause
-        result = await super().generate_impl(messages, request_params, tools)
+        result, summary = await self._generate_with_summary(messages, request_params, tools)
 
-        await self.show_assistant_message(result)
+        summary_text = (
+            Text(f"\n\n{summary.message}", style="dim red italic") if summary else None
+        )
+
+        await self.show_assistant_message(result, additional_message=summary_text)
         return result
 
     async def structured_impl(
@@ -182,8 +213,13 @@ class LlmAgent(LlmDecorator):
         if "user" == messages[-1].role:
             self.show_user_message(message=messages[-1])
 
-        result, message = await super().structured_impl(messages, model, request_params)
-        await self.show_assistant_message(message=message)
+        (result, message), summary = await self._structured_with_summary(
+            messages, model, request_params
+        )
+        summary_text = (
+            Text(f"\n\n{summary.message}", style="dim red italic") if summary else None
+        )
+        await self.show_assistant_message(message=message, additional_message=summary_text)
         return result, message
 
     # async def show_prompt_loaded(