fast-agent-mcp 0.3.0__py3-none-any.whl → 0.3.2__py3-none-any.whl

fast_agent/__init__.py

@@ -1,4 +1,5 @@
 """fast-agent - An MCP native agent application framework"""
+from typing import TYPE_CHECKING as _TYPE_CHECKING
 
 # Configuration and settings (safe - pure Pydantic models)
 from fast_agent.config import (
@@ -83,6 +84,11 @@ def __getattr__(name: str):
         raise AttributeError(f"module '{__name__}' has no attribute '{name}'")
 
 
+# Help static analyzers/IDEs resolve symbols and signatures without importing at runtime.
+if _TYPE_CHECKING:  # pragma: no cover - typing aid only
+    from fast_agent.core.fastagent import FastAgent as FastAgent  # noqa: F401
+
+
 __all__ = [
     # Core fast-agent components (lazy loaded)
     "Core",

fast_agent/agents/mcp_agent.py

@@ -43,7 +43,6 @@ from fast_agent.constants import HUMAN_INPUT_TOOL_NAME
 from fast_agent.core.exceptions import PromptExitError
 from fast_agent.core.logging.logger import get_logger
 from fast_agent.interfaces import FastAgentLLMProtocol
-from fast_agent.mcp.helpers.content_helpers import normalize_to_extended_list
 from fast_agent.mcp.mcp_aggregator import MCPAggregator
 from fast_agent.tools.elicitation import (
     get_elicitation_tool,
@@ -624,12 +623,9 @@ class McpAgent(ABC, ToolAgent):
         Returns:
             An instance of the specified model, or None if coercion fails
         """
-        assert self._llm
-        # Normalize all input types to a list of PromptMessageExtended
-        normalized_messages = normalize_to_extended_list(messages)
 
         with self._tracer.start_as_current_span(f"Agent: '{self._name}' structured"):
-            return await self._llm.structured(normalized_messages, model, request_params)
+            return await super().structured(messages, model, request_params)
 
     async def apply_prompt_messages(
         self, prompts: List[PromptMessageExtended], request_params: RequestParams | None = None

fast_agent/cli/commands/setup.py

@@ -9,50 +9,33 @@ console = Console()
 
 
 def load_template_text(filename: str) -> str:
-    """Load template text from packaged resources with a development fallback.
+    """Load template text from packaged resources only.
 
     Special-case: when requesting 'fastagent.secrets.yaml', read the
     'fastagent.secrets.yaml.example' template from resources, but still
     return its contents so we can write out the real secrets file name
     in the destination project.
     """
-    try:
-        # Prefer reading from installed package resources
-        from importlib.resources import files
+    from importlib.resources import files
 
-        # Map secrets filename to its '.example' template in resources
-        res_name = (
-            "fastagent.secrets.yaml.example" if filename == "fastagent.secrets.yaml" else filename
-        )
-        resource_path = files("fast_agent").joinpath("resources").joinpath("setup").joinpath(res_name)
-        if resource_path.is_file():
-            return resource_path.read_text()
-        # If the path exists but isn't a file, fall back to dev
-        raise FileNotFoundError
-    except (ImportError, ModuleNotFoundError, FileNotFoundError):
-        # Development environment fallback to repo path (project root/examples/setup)
-        try:
-            repo_root = Path(__file__).resolve().parents[4]
-        except IndexError:
-            repo_root = Path(__file__).resolve().parent
-        # Apply the same secrets mapping for the dev path
-        dev_name = (
-            "fastagent.secrets.yaml.example" if filename == "fastagent.secrets.yaml" else filename
-        )
-        dev_path = repo_root / "examples" / "setup" / dev_name
-        if dev_path.exists():
-            return dev_path.read_text()
-        raise RuntimeError(
-            "Setup template missing: '"
-            + filename
-            + "'.\n"
-            + "Expected at: "
-            + str(resource_path)
-            + " (package) or "
-            + str(dev_path)
-            + " (dev).\n"
-            + "This indicates a packaging issue. Please rebuild/reinstall fast-agent."
-        )
+    # Map requested filenames to resource templates
+    if filename == "fastagent.secrets.yaml":
+        res_name = "fastagent.secrets.yaml.example"
+    elif filename == "pyproject.toml":
+        res_name = "pyproject.toml.tmpl"
+    else:
+        res_name = filename
+    resource_path = (
+        files("fast_agent").joinpath("resources").joinpath("setup").joinpath(res_name)
+    )
+    if resource_path.is_file():
+        return resource_path.read_text()
+
+    raise RuntimeError(
+        f"Setup template missing: '{filename}'.\n"
+        f"Expected packaged resource at: {resource_path}.\n"
+        "This indicates a packaging issue. Please rebuild/reinstall fast-agent."
+    )
 
 
 # (No embedded template defaults; templates are the single source of truth.)
@@ -114,6 +97,7 @@ def init(
     console.print(f"  - {config_path}/fastagent.config.yaml")
     console.print(f"  - {config_path}/fastagent.secrets.yaml")
     console.print(f"  - {config_path}/agent.py")
+    console.print(f"  - {config_path}/pyproject.toml")
     if needs_gitignore:
         console.print(f"  - {config_path}/.gitignore")
 
@@ -135,6 +119,33 @@ def init(
     if create_file(config_path / "agent.py", load_template_text("agent.py"), force):
         created.append("agent.py")
 
+    # Create a minimal pyproject.toml so `uv run` installs dependencies
+    def _render_pyproject(template_text: str) -> str:
+        # Determine Python requirement from installed fast-agent-mcp metadata, fall back if missing
+        py_req = ">=3.13.7"
+        try:
+            from importlib.metadata import metadata
+
+            md = metadata("fast-agent-mcp")
+            req = md.get("Requires-Python")
+            if req:
+                py_req = req
+        except Exception:
+            pass
+
+        # Always use latest fast-agent-mcp (no version pin)
+        fast_agent_dep = '"fast-agent-mcp"'
+
+        return (
+            template_text.replace("{{python_requires}}", py_req)
+            .replace("{{fast_agent_dep}}", fast_agent_dep)
+        )
+
+    pyproject_template = load_template_text("pyproject.toml")
+    pyproject_text = _render_pyproject(pyproject_template)
+    if create_file(config_path / "pyproject.toml", pyproject_text, force):
+        created.append("pyproject.toml")
+
     # Only create .gitignore if none exists in parent directories
     if needs_gitignore and create_file(
         config_path / ".gitignore", load_template_text(".gitignore"), force

fast_agent/core/__init__.py

@@ -1,17 +1,52 @@
 """
-fast_agent.core package
+Core interfaces and decorators for fast-agent.
 
-Provides core subpackages (executor, logging) and lazily exposes the `Core`
-class to avoid circular imports during initialization.
+Public API:
+- `Core`: The core application container (lazy-loaded)
+- `FastAgent`: High-level, decorator-driven application class (lazy-loaded)
+- Decorators: `agent`, `custom`, `orchestrator`, `iterative_planner`,
+  `router`, `chain`, `parallel`, `evaluator_optimizer` (lazy-loaded)
 """
 
-__all__ = ["Core"]
+__all__ = [
+    "Core",
+    "FastAgent",
+    # Decorators
+    "agent",
+    "custom",
+    "orchestrator",
+    "iterative_planner",
+    "router",
+    "chain",
+    "parallel",
+    "evaluator_optimizer",
+]
 
 
 def __getattr__(name: str):
+    # Lazy imports to avoid heavy dependencies and circular imports at init time
     if name == "Core":
-        # Lazy import to avoid importing heavy dependencies during package init
         from .core_app import Core
 
         return Core
+    if name == "FastAgent":
+        from .fastagent import FastAgent
+
+        return FastAgent
+
+    # Decorators from direct_decorators
+    if name in {
+        "agent",
+        "custom",
+        "orchestrator",
+        "iterative_planner",
+        "router",
+        "chain",
+        "parallel",
+        "evaluator_optimizer",
+    }:
+        from . import direct_decorators as _dd
+
+        return getattr(_dd, name)
+
     raise AttributeError(f"module '{__name__}' has no attribute '{name}'")

fast_agent/core/fastagent.py

@@ -251,6 +251,33 @@ class FastAgent:
         return self.app.context
 
     # Decorator methods with type-safe implementations
+    # Provide annotations so IDEs can discover these attributes on instances
+    if TYPE_CHECKING:  # pragma: no cover - typing aid only
+        from typing import Awaitable, ParamSpec, Protocol, TypeVar  # re-import for type block
+
+        from fast_agent.core.direct_decorators import (
+            DecoratedAgentProtocol,
+            DecoratedChainProtocol,
+            DecoratedEvaluatorOptimizerProtocol,
+            DecoratedOrchestratorProtocol,
+            DecoratedParallelProtocol,
+            DecoratedRouterProtocol,
+        )
+
+        P = ParamSpec("P")
+        R = TypeVar("R")
+
+        # These are declared as attributes so IDEs show autocomplete on `fast.agent` etc.
+        def agent(self, *args, **kwargs) -> "DecoratedAgentProtocol[P, R]": ...
+        def custom(self, *args, **kwargs) -> "DecoratedAgentProtocol[P, R]": ...
+        def orchestrator(self, *args, **kwargs) -> "DecoratedOrchestratorProtocol[P, R]": ...
+        def iterative_planner(self, *args, **kwargs) -> "DecoratedOrchestratorProtocol[P, R]": ...
+        def router(self, *args, **kwargs) -> "DecoratedRouterProtocol[P, R]": ...
+        def chain(self, *args, **kwargs) -> "DecoratedChainProtocol[P, R]": ...
+        def parallel(self, *args, **kwargs) -> "DecoratedParallelProtocol[P, R]": ...
+        def evaluator_optimizer(self, *args, **kwargs) -> "DecoratedEvaluatorOptimizerProtocol[P, R]": ...
+
+    # Runtime bindings (actual implementations)
     agent = agent_decorator
     custom = custom_decorator
     orchestrator = orchestrator_decorator

fast_agent/mcp/__init__.py

@@ -1,7 +1,8 @@
 """
-MCP utilities and types for Fast Agent.
+MCP utilities and types for fast-agent.
 
 Public API:
+- `Prompt`: helper for constructing MCP prompts/messages.
 - `PromptMessageExtended`: canonical message container used internally by providers.
 - Helpers from `fast_agent.mcp.helpers` (re-exported for convenience).
 
@@ -26,6 +27,7 @@ from .helpers import (
 from .prompt_message_extended import PromptMessageExtended
 
 __all__ = [
+    "Prompt",
     "PromptMessageExtended",
     # Helpers
     "get_text",
@@ -41,3 +43,12 @@ __all__ = [
     "split_thinking_content",
     "text_content",
 ]
+
+
+def __getattr__(name: str):
+    # Lazily import to avoid circular imports with fast_agent.types
+    if name == "Prompt":
+        from .prompt import Prompt  # local import
+
+        return Prompt
+    raise AttributeError(f"module '{__name__}' has no attribute '{name}'")

fast_agent/resources/setup/pyproject.toml.tmpl

@@ -0,0 +1,17 @@
+[project]
+name = "fast-agent-app"
+version = "0.1.0"
+description = "a simple fast-agent application"
+readme = "README.md"
+requires-python = "{{python_requires}}"
+dependencies = [
+  {{fast_agent_dep}}
+]
+
+[tool.uv]
+package = true
+
+# Optional convenience entry point if you later package this app:
+[project.scripts]
+fast-agent-app = "agent:main"
+

{fast_agent_mcp-0.3.0.dist-info → fast_agent_mcp-0.3.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.3.0
+Version: 0.3.2
 Summary: Define, Prompt and Test MCP enabled Agents and Workflows
 Author-email: Shaun Smith <fastagent@llmindset.co.uk>
 License:                                  Apache License

{fast_agent_mcp-0.3.0.dist-info → fast_agent_mcp-0.3.2.dist-info}/RECORD

@@ -1,4 +1,4 @@
-fast_agent/__init__.py,sha256=bmws6wJQefvfO0Cd5x9VLTI7RCdjF6NqZtWSj_14tv0,3349
+fast_agent/__init__.py,sha256=sljPsYHqDmv5v0fBpQdhtwBm5IDyu37lwdSQA0IPEwQ,3628
 fast_agent/config.py,sha256=8CPbTctXGdSneAkMory5ZRXkUsUj4AyKnaf_nmEamQA,19886
 fast_agent/constants.py,sha256=d5EMSO2msRkjRFz8MgnnhpMnO3woqKP0EcQ4b_yI60w,235
 fast_agent/context.py,sha256=nBelOqehSH91z3aG2nYhwETP-biRzz-iuA2fqmKdHP8,7700
@@ -11,7 +11,7 @@ fast_agent/agents/__init__.py,sha256=kBI2VWTitLyWf8K3dFMyuE-K7Ufp7mkHBomM2K3I8H8
 fast_agent/agents/agent_types.py,sha256=ugolD3lC2KxSfBYjjRf9HjNATZaFx1o4Fhjb15huSgk,1776
 fast_agent/agents/llm_agent.py,sha256=iuy3kO5Q-f9bm3tjYLG2Wurd0gK2sLhTfTkSnfVWzSw,8311
 fast_agent/agents/llm_decorator.py,sha256=yzaYqsT8lqey4dbZrv1oK9qUqf8I2RMPYiWOy0uVHqA,16443
-fast_agent/agents/mcp_agent.py,sha256=R-OeHu0dO61z0vQwtCqKL2WLs1o9kHdsu74Fu4ALaCM,35494
+fast_agent/agents/mcp_agent.py,sha256=BMSTcGd9_SdoyEGNGVAWXu8ubaE1TAeAMl-2c_wymQU,35240
 fast_agent/agents/tool_agent.py,sha256=zSaVQH-mBICgE3ildeZx24i00u_KMOk5P4OuJBTiQ3g,6571
 fast_agent/agents/workflow/chain_agent.py,sha256=Pd8dOH_YdKu3LXsKa4fwqzY_B2qVuhzdfCUiKi5v17s,6293
 fast_agent/agents/workflow/evaluator_optimizer.py,sha256=rhzazy8Aj-ydId6kmBC77TmtYZ5mirSe7eV6PPMWkBA,12040
@@ -29,16 +29,16 @@ fast_agent/cli/commands/check_config.py,sha256=nMiOBs-Sc7XqUU6tLReLn1JPXHqjR0Kuz
 fast_agent/cli/commands/go.py,sha256=VRiHq9h1UGIndLdQJMAwEM6bwTGy-h5n6w__bYCGaHM,15094
 fast_agent/cli/commands/quickstart.py,sha256=hQZYlvktPdDNdaZOZkBgcvi8u0bMW5yFhz4BLBZ251I,21175
 fast_agent/cli/commands/server_helpers.py,sha256=BmljUNLIcZdFpffYxEPfJf8rrX3JhTzMA7VONoZLAjM,3650
-fast_agent/cli/commands/setup.py,sha256=nPo9sI1BZTM_7P97De_nzmX61JUlIt9Mti8c2K7D9aw,6208
+fast_agent/cli/commands/setup.py,sha256=rCp5wUs5kjbHJqi3Jz9ByCpOSvJ7L4KB0hpcKB8qpCM,6377
 fast_agent/cli/commands/url_parser.py,sha256=ivWrsODeVO9GGERkaTawYIxZuf57uRga1gubwT3n3vU,5907
-fast_agent/core/__init__.py,sha256=hlVPmPYKnR88k8awP3aEn5V3DhNK4UwaLA1DmUDNIfQ,448
+fast_agent/core/__init__.py,sha256=RsHaeZTQmmNC6cd--kGsnu-jp053cr7h0TUMEnBcMQ0,1223
 fast_agent/core/agent_app.py,sha256=cdzNwpb--SUNYbhkUX6RolqVnxJ5WSchxw5I4gFrvpk,16836
 fast_agent/core/core_app.py,sha256=_8Di00HD2BzWhCAaopAUS0Hzc7pg0249QUUfPuLZ36A,4266
 fast_agent/core/direct_decorators.py,sha256=eHhQfKLbeaoH-W0snzAVJRxga7wTNGXBk5DEJTAbZB8,23642
 fast_agent/core/direct_factory.py,sha256=HGGnnF4Z9k_N3r0Iin_sp2Ch308To1oKX8JTKHjuUq0,21350
 fast_agent/core/error_handling.py,sha256=xoyS2kLe0eG0bj2eSJCJ2odIhGUve2SbDR7jP-A-uRw,624
 fast_agent/core/exceptions.py,sha256=ENAD_qGG67foxy6vDkIvc-lgopIUQy6O7zvNPpPXaQg,2289
-fast_agent/core/fastagent.py,sha256=duxLEQMXdKqvKXAxbbe86_V7ZQR-etR-OMt-XfvLB1I,25351
+fast_agent/core/fastagent.py,sha256=PJPeRREuQqlqdVub7RqamfsArpoZ1D50B8Hz-CsDenA,26792
 fast_agent/core/prompt.py,sha256=qNUFlK3KtU7leYysYUglzBYQnEYiXu__iR_T8189zc0,203
 fast_agent/core/validation.py,sha256=GZ0hUTxkr5KMY1wr6_ifDy91Ycvcx384gZEMOwdie9w,12681
 fast_agent/core/executor/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -94,7 +94,7 @@ fast_agent/llm/provider/openai/llm_xai.py,sha256=fEyO9XlU3Ef1a-cXdJl0Qe-FmE562cA
 fast_agent/llm/provider/openai/multipart_converter_openai.py,sha256=M7cbM4F8_xycPtVHJv1kBYYBX7KRXyYPCDb1YKQEgo0,20925
 fast_agent/llm/provider/openai/openai_multipart.py,sha256=uuoRMYWiznYksBODbknBuqe65UxEHE1h7AphHpdnCCM,6864
 fast_agent/llm/provider/openai/openai_utils.py,sha256=RI9UgF7SGkZ02bAep7glvLy3erbismmZp7wXDsRoJPQ,2034
-fast_agent/mcp/__init__.py,sha256=447bAeavOiy_Y8hKSs1XBfmfIKTcleYtdDb-sLFEkac,1114
+fast_agent/mcp/__init__.py,sha256=fS322k3GsnZ8LcPImoAy_TtiqgiJgDmMlbgCc7AvVdQ,1458
 fast_agent/mcp/common.py,sha256=MpSC0fLO21RcDz4VApah4C8_LisVGz7OXkR17Xw-9mY,431
 fast_agent/mcp/elicitation_factory.py,sha256=p9tSTcs1KSCXkFcFv1cG7vJBpS1PedOJ5bcBJp0qKw4,3172
 fast_agent/mcp/elicitation_handlers.py,sha256=LWNKn850Ht9V1SGTfAZDptlsgzrycNhOPNsCcqzsuUY,6884
@@ -180,6 +180,7 @@ fast_agent/resources/setup/.gitignore,sha256=UQKYvhK6samGg5JZg613XiuGUkUAz2qzE1W
 fast_agent/resources/setup/agent.py,sha256=co2lm190iQqOlRhup78X5BKHSB-RqLn3tZdxh2yaGhA,422
 fast_agent/resources/setup/fastagent.config.yaml,sha256=JpezZSP5-ybUlZJaeQG1EoUONXmzmDhdAR6JIpbb-jA,1356
 fast_agent/resources/setup/fastagent.secrets.yaml.example,sha256=ht-i2_SpAyeXG2OnG_vOA1n7gRsGIInxp9g5Nio-jpI,1038
+fast_agent/resources/setup/pyproject.toml.tmpl,sha256=b_dL9TBAzA4sPOkVZd3psMKFT-g_gef0n2NcANojEqs,343
 fast_agent/tools/elicitation.py,sha256=8FaNvuN__LAM328VSJ5T4Bg3m8auHraqYvIYv6Eh4KU,13464
 fast_agent/types/__init__.py,sha256=IpUWlzx3u_3h99F2IKJ8aPjyGZXguOwkOVJKGrst6hg,951
 fast_agent/types/llm_stop_reason.py,sha256=bWe97OfhALUe8uQeAQOnTdPlYzJiabIfo8u38kPgj3Q,2293
@@ -195,8 +196,8 @@ fast_agent/ui/mermaid_utils.py,sha256=MpcRyVCPMTwU1XeIxnyFg0fQLjcyXZduWRF8NhEqvX
 fast_agent/ui/progress_display.py,sha256=hajDob65PttiJ2mPS6FsCtnmTcnyvDWGn-UqQboXqkQ,361
 fast_agent/ui/rich_progress.py,sha256=vMeDD5cybsPf_0IjOM98U8TVaE_yYIOKZa8JnRgTYUo,7451
 fast_agent/ui/usage_display.py,sha256=ltJpn_sDzo8PDNSXWx-QdEUbQWUnhmajCItNt5mA5rM,7285
-fast_agent_mcp-0.3.0.dist-info/METADATA,sha256=Vff6l-8Pb92peB_JNSm5Z-qYTbx9px2Q-jOY59KT-F0,30462
-fast_agent_mcp-0.3.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-fast_agent_mcp-0.3.0.dist-info/entry_points.txt,sha256=i6Ujja9J-hRxttOKqTYdbYP_tyaS4gLHg53vupoCSsg,199
-fast_agent_mcp-0.3.0.dist-info/licenses/LICENSE,sha256=Gx1L3axA4PnuK4FxsbX87jQ1opoOkSFfHHSytW6wLUU,10935
-fast_agent_mcp-0.3.0.dist-info/RECORD,,
+fast_agent_mcp-0.3.2.dist-info/METADATA,sha256=iaD5FYCGdDqTIAnGvq32PatCS2P-SbVzy-x79bmfIUA,30462
+fast_agent_mcp-0.3.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+fast_agent_mcp-0.3.2.dist-info/entry_points.txt,sha256=i6Ujja9J-hRxttOKqTYdbYP_tyaS4gLHg53vupoCSsg,199
+fast_agent_mcp-0.3.2.dist-info/licenses/LICENSE,sha256=Gx1L3axA4PnuK4FxsbX87jQ1opoOkSFfHHSytW6wLUU,10935
+fast_agent_mcp-0.3.2.dist-info/RECORD,,