golf-mcp 0.1.16__tar.gz → 0.1.17__tar.gz

{golf_mcp-0.1.16 → golf_mcp-0.1.17}/.docs/docs.md

@@ -49,7 +49,7 @@ Given a component file `C` with absolute path
 let `PathRev = [pₙ, …, p₁]` (reverse order of parent dirs under the category). The **ID** is
 
 ```
-<filename> + ("-" + "-".join(PathRev) if PathRev else "")
+<filename> + ("_" + "_".join(PathRev) if PathRev else "")
 ```
 
 ### Formal Definition (BNF)
@@ -190,7 +190,7 @@ def run(charge_id: str, amount: int) -> dict:
 from tools.payments.refund import submit as _submit
 
 mcp.tool(
-    name="submit-refund-payments",
+    name="submit_refund_payments",
     description="Submit a refund request to Stripe."
 )(_submit.run)
 ```

{golf_mcp-0.1.16/src/golf_mcp.egg-info → golf_mcp-0.1.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: golf-mcp
-Version: 0.1.16
+Version: 0.1.17
 Summary: Framework for building MCP servers
 Author-email: Antoni Gmitruk <antoni@golf.dev>
 License-Expression: Apache-2.0
@@ -21,7 +21,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: typer>=0.15.4
 Requires-Dist: rich>=14.0.0
-Requires-Dist: fastmcp>=2.0.0
+Requires-Dist: fastmcp<2.6.0,>=2.0.0
 Requires-Dist: pydantic>=2.11.0
 Requires-Dist: python-dotenv>=1.1.0
 Requires-Dist: black>=24.10.0
@@ -128,7 +128,7 @@ A Golf project initialized with `golf init` will have a structure similar to thi
 
 -   **`golf.json`**: Configures server name, port, transport, telemetry, and other build settings.
 -   **`tools/`**, **`resources/`**, **`prompts/`**: Contain your Python files, each defining a single component. These directories can also contain nested subdirectories to further organize your components (e.g., `tools/payments/charge.py`). The module docstring of each file serves as the component's description.
-    -   Component IDs are automatically derived from their file path. For example, `tools/hello.py` becomes `hello`, and a nested file like `tools/payments/submit.py` would become `submit-payments` (filename, followed by reversed parent directories under the main category, joined by hyphens).
+    -   Component IDs are automatically derived from their file path. For example, `tools/hello.py` becomes `hello`, and a nested file like `tools/payments/submit.py` would become `submit_payments` (filename, followed by reversed parent directories under the main category, joined by underscores).
 -   **`common.py`** (not shown, but can be placed in subdirectories like `tools/payments/common.py`): Used to share code (clients, models, etc.) among components in the same subdirectory.
 
 ## Example: Defining a Tool
@@ -178,6 +178,10 @@ The `golf.json` file is the heart of your Golf project configuration. Here's wha
                                       // - "streamable-http": HTTP with streaming support
                                       // - "stdio": Standard I/O (for CLI integration)
   
+  // HTTP Transport Configuration (optional)
+  "stateless_http": false,            // Make streamable-http transport stateless (new session per request)
+                                      // When true, server restarts won't break existing client connections
+  
   // Health Check Configuration (optional)
   "health_check_enabled": false,      // Enable health check endpoint for Kubernetes/load balancers
   "health_check_path": "/health",     // HTTP path for health check endpoint
@@ -198,6 +202,7 @@ The `golf.json` file is the heart of your Golf project configuration. Here's wha
   - `"streamable-http"` provides HTTP streaming for traditional API clients
   - `"stdio"` enables integration with command-line tools and scripts
 - **`host` & `port`**: Control where your server listens. Use `"127.0.0.1"` for local development or `"0.0.0.0"` to accept external connections.
+- **`stateless_http`**: When true, makes the streamable-http transport stateless by creating a new session for each request. This ensures that server restarts don't break existing client connections, making the server truly stateless.
 - **`health_check_enabled`**: When true, enables a health check endpoint for Kubernetes readiness/liveness probes and load balancers
 - **`health_check_path`**: Customizable path for the health check endpoint (defaults to "/health")
 - **`health_check_response`**: Customizable response text for successful health checks (defaults to "OK")

{golf_mcp-0.1.16 → golf_mcp-0.1.17}/README.md

@@ -90,7 +90,7 @@ A Golf project initialized with `golf init` will have a structure similar to thi
 
 -   **`golf.json`**: Configures server name, port, transport, telemetry, and other build settings.
 -   **`tools/`**, **`resources/`**, **`prompts/`**: Contain your Python files, each defining a single component. These directories can also contain nested subdirectories to further organize your components (e.g., `tools/payments/charge.py`). The module docstring of each file serves as the component's description.
-    -   Component IDs are automatically derived from their file path. For example, `tools/hello.py` becomes `hello`, and a nested file like `tools/payments/submit.py` would become `submit-payments` (filename, followed by reversed parent directories under the main category, joined by hyphens).
+    -   Component IDs are automatically derived from their file path. For example, `tools/hello.py` becomes `hello`, and a nested file like `tools/payments/submit.py` would become `submit_payments` (filename, followed by reversed parent directories under the main category, joined by underscores).
 -   **`common.py`** (not shown, but can be placed in subdirectories like `tools/payments/common.py`): Used to share code (clients, models, etc.) among components in the same subdirectory.
 
 ## Example: Defining a Tool
@@ -140,6 +140,10 @@ The `golf.json` file is the heart of your Golf project configuration. Here's wha
                                       // - "streamable-http": HTTP with streaming support
                                       // - "stdio": Standard I/O (for CLI integration)
   
+  // HTTP Transport Configuration (optional)
+  "stateless_http": false,            // Make streamable-http transport stateless (new session per request)
+                                      // When true, server restarts won't break existing client connections
+  
   // Health Check Configuration (optional)
   "health_check_enabled": false,      // Enable health check endpoint for Kubernetes/load balancers
   "health_check_path": "/health",     // HTTP path for health check endpoint
@@ -160,6 +164,7 @@ The `golf.json` file is the heart of your Golf project configuration. Here's wha
   - `"streamable-http"` provides HTTP streaming for traditional API clients
   - `"stdio"` enables integration with command-line tools and scripts
 - **`host` & `port`**: Control where your server listens. Use `"127.0.0.1"` for local development or `"0.0.0.0"` to accept external connections.
+- **`stateless_http`**: When true, makes the streamable-http transport stateless by creating a new session for each request. This ensures that server restarts don't break existing client connections, making the server truly stateless.
 - **`health_check_enabled`**: When true, enables a health check endpoint for Kubernetes readiness/liveness probes and load balancers
 - **`health_check_path`**: Customizable path for the health check endpoint (defaults to "/health")
 - **`health_check_response`**: Customizable response text for successful health checks (defaults to "OK")

{golf_mcp-0.1.16 → golf_mcp-0.1.17}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "golf-mcp"
-version = "0.1.16"
+version = "0.1.17"
 description = "Framework for building MCP servers"
 authors = [
     {name = "Antoni Gmitruk", email = "antoni@golf.dev"}
@@ -28,7 +28,7 @@ classifiers = [
 dependencies = [
     "typer>=0.15.4",
     "rich>=14.0.0",
-    "fastmcp>=2.0.0",
+    "fastmcp>=2.0.0,<2.6.0",
     "pydantic>=2.11.0",
     "python-dotenv>=1.1.0",
     "black>=24.10.0",
@@ -64,7 +64,7 @@ golf = ["examples/**/*"]
 
 [tool.poetry]
 name = "golf-mcp"
-version = "0.1.16"
+version = "0.1.17"
 description = "Framework for building MCP servers with zero boilerplate"
 authors = ["Antoni Gmitruk <antoni@golf.dev>"]
 license = "Apache-2.0"
@@ -86,7 +86,7 @@ classifiers = [
 
 [tool.poetry.dependencies]
 python = ">=3.8" # Match requires-python
-fastmcp = ">=2.0.0"
+fastmcp = ">=2.0.0,<2.6.0"
 typer = {extras = ["all"], version = ">=0.15.4"}
 pydantic = ">=2.11.0"
 rich = ">=14.0.0"

golf_mcp-0.1.17/src/golf/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.17"

{golf_mcp-0.1.16 → golf_mcp-0.1.17}/src/golf/cli/main.py

@@ -121,7 +121,11 @@ def build_dev(
         None, "--output-dir", "-o", help="Directory to output the built project"
     ),
 ) -> None:
-    """Build a development version with environment variables copied."""
+    """Build a development version with app environment variables copied.
+
+    Golf credentials (GOLF_*) are always loaded from .env for build operations.
+    All environment variables are copied to the built project for development.
+    """
     # Find project root directory
     project_root, config_path = find_project_root()
 
@@ -173,7 +177,14 @@ def build_prod(
         None, "--output-dir", "-o", help="Directory to output the built project"
     ),
 ) -> None:
-    """Build a production version without copying environment variables."""
+    """Build a production version for deployment.
+
+    Golf credentials (GOLF_*) are always loaded from .env for build operations
+    (platform registration, resource updates). App environment variables are
+    NOT copied for security - provide them in your deployment environment.
+
+    Your production deployment must include GOLF_* vars for runtime telemetry.
+    """
     # Find project root directory
     project_root, config_path = find_project_root()
 

{golf_mcp-0.1.16 → golf_mcp-0.1.17}/src/golf/commands/init.py

@@ -7,7 +7,12 @@ from rich.console import Console
 from rich.progress import Progress, SpinnerColumn, TextColumn
 from rich.prompt import Confirm
 
-from golf.core.telemetry import track_command, track_event
+from golf.core.telemetry import (
+    track_command,
+    track_event,
+    set_telemetry_enabled,
+    load_telemetry_preference,
+)
 
 console = Console()
 
@@ -95,6 +100,9 @@ def initialize_project(
             # Copy directory structure
             _copy_template(template_dir, output_dir, project_name)
 
+        # Ask for telemetry consent
+        _prompt_for_telemetry_consent()
+
         # Create virtual environment
         console.print("[bold green]Project initialized successfully![/bold green]")
         console.print("\nTo get started, run:")
@@ -207,6 +215,60 @@ def _copy_template(source_dir: Path, target_dir: Path, project_name: str) -> Non
             f.write("dist/\n")
 
 
+def _prompt_for_telemetry_consent() -> None:
+    """Prompt user for telemetry consent and save their preference."""
+    import os
+
+    # Skip prompt in test mode, when telemetry is explicitly disabled, or if preference already exists
+    if os.environ.get("GOLF_TEST_MODE", "").lower() in ("1", "true", "yes", "on"):
+        return
+
+    # Skip if telemetry is explicitly disabled in environment
+    if os.environ.get("GOLF_TELEMETRY", "").lower() in ("0", "false", "no", "off"):
+        return
+
+    # Check if user already has a saved preference
+    existing_preference = load_telemetry_preference()
+    if existing_preference is not None:
+        return  # User already made a choice
+
+    console.print()
+    console.rule("[bold blue]Anonymous usage analytics[/bold blue]", style="blue")
+    console.print()
+    console.print(
+        "Golf can collect [bold]anonymous usage analytics[/bold] to help improve the tool."
+    )
+    console.print()
+    console.print("[dim]What we collect:[/dim]")
+    console.print("  • Command usage (init, build, run)")
+    console.print("  • Error types (to fix bugs)")
+    console.print("  • Golf version and Python version")
+    console.print("  • Operating system type")
+    console.print()
+    console.print("[dim]What we DON'T collect:[/dim]")
+    console.print("  • Your code or project content")
+    console.print("  • File paths or project names")
+    console.print("  • Personal information")
+    console.print("  • IP addresses")
+    console.print()
+    console.print(
+        "You can change this anytime by setting GOLF_TELEMETRY=0 in your environment."
+    )
+    console.print()
+
+    enable_telemetry = Confirm.ask(
+        "[bold]Enable anonymous usage analytics?[/bold]", default=False
+    )
+
+    set_telemetry_enabled(enable_telemetry, persist=True)
+
+    if enable_telemetry:
+        console.print("[green]✓[/green] Anonymous analytics enabled")
+    else:
+        console.print("[yellow]○[/yellow] Anonymous analytics disabled")
+    console.print()
+
+
 def _is_text_file(path: Path) -> bool:
     """Check if a file is a text file that needs variable substitution.
 

{golf_mcp-0.1.16 → golf_mcp-0.1.17}/src/golf/core/builder.py

@@ -561,14 +561,6 @@ class CodeGenerator:
         # Add OpenTelemetry imports if enabled
         if self.settings.opentelemetry_enabled:
             imports.extend(generate_telemetry_imports())
-            imports.append("")
-
-        # Add imports section for different transport methods
-        if self.settings.transport == "sse" or self.settings.transport in [
-            "streamable-http",
-            "http",
-        ]:
-            imports.append("import uvicorn")
 
         # Add health check imports if enabled
         if self.settings.health_check_enabled:
@@ -664,7 +656,10 @@ class CodeGenerator:
                 # Add code to register this component
                 if self.settings.opentelemetry_enabled:
                     # Use telemetry instrumentation
-                    registration = f"# Register the {component_type.value} '{component.name}' with telemetry"
+                    registration = (
+                        f"# Register the {component_type.value} "
+                        f"'{component.name}' with telemetry"
+                    )
                     entry_func = (
                         component.entry_function
                         if hasattr(component, "entry_function")
@@ -672,19 +667,31 @@ class CodeGenerator:
                         else "export"
                     )
 
-                    # Debug: Add logging to verify wrapping
-                    registration += f"\n_wrapped_func = instrument_{component_type.value}({full_module_path}.{entry_func}, '{component.name}')"
+                    registration += (
+                        f"\n_wrapped_func = instrument_{component_type.value}("
+                        f"{full_module_path}.{entry_func}, '{component.name}')"
+                    )
 
                     if component_type == ComponentType.TOOL:
-                        registration += f'\nmcp.add_tool(_wrapped_func, name="{component.name}", description="{component.docstring or ""}"'
+                        registration += (
+                            f'\nmcp.add_tool(_wrapped_func, name="{component.name}", '
+                            f'description="{component.docstring or ""}"'
+                        )
                         # Add annotations if present
                         if hasattr(component, "annotations") and component.annotations:
                             registration += f", annotations={component.annotations}"
                         registration += ")"
                     elif component_type == ComponentType.RESOURCE:
-                        registration += f'\nmcp.add_resource_fn(_wrapped_func, uri="{component.uri_template}", name="{component.name}", description="{component.docstring or ""}")'
+                        registration += (
+                            f"\nmcp.add_resource_fn(_wrapped_func, "
+                            f'uri="{component.uri_template}", name="{component.name}", '
+                            f'description="{component.docstring or ""}")'
+                        )
                     else:  # PROMPT
-                        registration += f'\nmcp.add_prompt(_wrapped_func, name="{component.name}", description="{component.docstring or ""}")'
+                        registration += (
+                            f'\nmcp.add_prompt(_wrapped_func, name="{component.name}", '
+                            f'description="{component.docstring or ""}")'
+                        )
                 else:
                     # Standard registration without telemetry
                     if component_type == ComponentType.TOOL:
@@ -795,6 +802,10 @@ class CodeGenerator:
             for key, value in auth_components["fastmcp_args"].items():
                 mcp_constructor_args.append(f"{key}={value}")
 
+        # Add stateless HTTP parameter if enabled
+        if self.settings.stateless_http:
+            mcp_constructor_args.append("stateless_http=True")
+
         # Add OpenTelemetry parameters if enabled
         if self.settings.opentelemetry_enabled:
             mcp_constructor_args.append("lifespan=telemetry_lifespan")
@@ -803,6 +814,18 @@ class CodeGenerator:
         server_code_lines.append(mcp_instance_line)
         server_code_lines.append("")
 
+        # Add early telemetry initialization if enabled (before component registration)
+        early_telemetry_init = []
+        if self.settings.opentelemetry_enabled:
+            early_telemetry_init.extend(
+                [
+                    "# Initialize telemetry early to ensure instrumentation works",
+                    "from golf.telemetry.instrumentation import init_telemetry",
+                    f'init_telemetry("{self.settings.name}")',
+                    "",
+                ]
+            )
+
         # Main entry point with transport-specific app initialization
         main_code = [
             'if __name__ == "__main__":',
@@ -830,71 +853,84 @@ class CodeGenerator:
 
         # Transport-specific run methods
         if self.settings.transport == "sse":
-            # Check if we need to add API key middleware for SSE
+            # Check if we need middleware for SSE
+            middleware_setup = []
+            middleware_list = []
+
             api_key_config = get_api_key_config()
             if auth_components.get("has_auth") and api_key_config:
-                main_code.extend(
-                    [
-                        "    # For SSE with API key auth, we need to get the app and add middleware",
-                        '    app = mcp.http_app(transport="sse")',
-                        "    app.add_middleware(ApiKeyMiddleware)",
-                    ]
+                middleware_setup.append(
+                    "    from starlette.middleware import Middleware"
                 )
-            else:
+                middleware_list.append("Middleware(ApiKeyMiddleware)")
+
+            # Add OpenTelemetry middleware if enabled
+            if self.settings.opentelemetry_enabled:
+                middleware_setup.append(
+                    "    from opentelemetry.instrumentation.asgi import OpenTelemetryMiddleware"
+                )
+                middleware_setup.append(
+                    "    from starlette.middleware import Middleware"
+                )
+                middleware_list.append("Middleware(OpenTelemetryMiddleware)")
+
+            if middleware_setup:
+                main_code.extend(middleware_setup)
+                main_code.append(f"    middleware = [{', '.join(middleware_list)}]")
+                main_code.append("")
                 main_code.extend(
                     [
-                        "    # For SSE, get the app to add middleware",
-                        '    app = mcp.http_app(transport="sse")',
+                        "    # Run SSE server with middleware using FastMCP's run method",
+                        '    mcp.run(transport="sse", host=host, port=port, log_level="info", middleware=middleware)',
                     ]
                 )
-
-            # Add OpenTelemetry middleware to the SSE app if enabled
-            if self.settings.opentelemetry_enabled:
+            else:
                 main_code.extend(
                     [
-                        "    # Apply OpenTelemetry middleware to the SSE app",
-                        "    from opentelemetry.instrumentation.asgi import OpenTelemetryMiddleware",
-                        "    app = OpenTelemetryMiddleware(app)",
+                        "    # Run SSE server using FastMCP's run method",
+                        '    mcp.run(transport="sse", host=host, port=port, log_level="info")',
                     ]
                 )
 
-            main_code.extend(
-                [
-                    "    # Run with the configured app",
-                    '    uvicorn.run(app, host=host, port=port, log_level="info")',
-                ]
-            )
         elif self.settings.transport in ["streamable-http", "http"]:
-            main_code.extend(
-                [
-                    "    # Create HTTP app and run with uvicorn",
-                    "    app = mcp.http_app()",
-                ]
-            )
+            # Check if we need middleware for streamable-http
+            middleware_setup = []
+            middleware_list = []
 
-            # Check if we need to add API key middleware
             api_key_config = get_api_key_config()
             if auth_components.get("has_auth") and api_key_config:
+                middleware_setup.append(
+                    "    from starlette.middleware import Middleware"
+                )
+                middleware_list.append("Middleware(ApiKeyMiddleware)")
+
+            # Add OpenTelemetry middleware if enabled
+            if self.settings.opentelemetry_enabled:
+                middleware_setup.append(
+                    "    from opentelemetry.instrumentation.asgi import OpenTelemetryMiddleware"
+                )
+                middleware_setup.append(
+                    "    from starlette.middleware import Middleware"
+                )
+                middleware_list.append("Middleware(OpenTelemetryMiddleware)")
+
+            if middleware_setup:
+                main_code.extend(middleware_setup)
+                main_code.append(f"    middleware = [{', '.join(middleware_list)}]")
+                main_code.append("")
                 main_code.extend(
                     [
-                        "    # Add API key middleware",
-                        "    app.add_middleware(ApiKeyMiddleware)",
+                        "    # Run HTTP server with middleware using FastMCP's run method",
+                        '    mcp.run(transport="streamable-http", host=host, port=port, log_level="info", middleware=middleware)',
                     ]
                 )
-
-            # Add OpenTelemetry middleware to the HTTP app if enabled
-            if self.settings.opentelemetry_enabled:
+            else:
                 main_code.extend(
                     [
-                        "    # Apply OpenTelemetry middleware to the HTTP app",
-                        "    from opentelemetry.instrumentation.asgi import OpenTelemetryMiddleware",
-                        "    app = OpenTelemetryMiddleware(app)",
+                        "    # Run HTTP server using FastMCP's run method",
+                        '    mcp.run(transport="streamable-http", host=host, port=port, log_level="info")',
                     ]
                 )
-
-            main_code.extend(
-                ['    uvicorn.run(app, host=host, port=port, log_level="info")']
-            )
         else:
             # For stdio transport, use mcp.run()
             main_code.extend(
@@ -917,12 +953,13 @@ class CodeGenerator:
 
         # Combine all sections
         # Order: imports, env_section, auth_setup, server_code (mcp init),
-        # post_init (API key middleware), component_registrations, main_code (run block)
+        # early_telemetry_init, component_registrations, health_check_code, main_code (run block)
         code = "\n".join(
             imports
             + env_section
             + auth_setup_code
             + server_code_lines
+            + early_telemetry_init
             + component_registrations
             + health_check_code
             + main_code
@@ -955,6 +992,21 @@ def build_project(
         build_env: Build environment ('dev' or 'prod')
         copy_env: Whether to copy environment variables to the built app
     """
+    # Load Golf credentials from .env for build operations (platform registration, etc.)
+    # This happens regardless of copy_env setting to ensure build process works
+    from dotenv import load_dotenv
+
+    project_env_file = project_path / ".env"
+    if project_env_file.exists():
+        # Load GOLF_* variables for build process
+        load_dotenv(project_env_file, override=False)
+
+        # Only log if we actually found the specific Golf platform credentials
+        has_api_key = "GOLF_API_KEY" in os.environ
+        has_server_id = "GOLF_SERVER_ID" in os.environ
+        if has_api_key and has_server_id:
+            console.print("[dim]Loaded Golf credentials for build operations[/dim]")
+
     # Execute pre_build.py if it exists
     pre_build_path = project_path / "pre_build.py"
     if pre_build_path.exists():
@@ -1056,9 +1108,6 @@ def build_project(
             env_vars_to_write["OTEL_TRACES_EXPORTER"] = (
                 settings.opentelemetry_default_exporter
             )
-            console.print(
-                f"[info]Setting OTEL_TRACES_EXPORTER to '{settings.opentelemetry_default_exporter}' from golf.json in built app's .env[/info]"
-            )
 
     # 3. Apply Golf's project name as OTEL_SERVICE_NAME if not already set
     # (Ensures service name defaults to project name if not specified in user's .env)
@@ -1110,6 +1159,36 @@ def build_project(
     )
     generator.generate()
 
+    # Platform registration (only for prod builds)
+    if build_env == "prod":
+        console.print(
+            "[dim]Registering with Golf platform and updating resources...[/dim]"
+        )
+        import asyncio
+
+        try:
+            from golf.core.platform import register_project_with_platform
+
+            asyncio.run(
+                register_project_with_platform(
+                    project_path=project_path,
+                    settings=settings,
+                    components=generator.components,
+                )
+            )
+            console.print("[green]✓ Platform registration completed[/green]")
+        except ImportError:
+            console.print(
+                "[yellow]Warning: Platform registration module not available[/yellow]"
+            )
+        except Exception as e:
+            console.print(
+                f"[yellow]Warning: Platform registration failed: {e}[/yellow]"
+            )
+            console.print(
+                "[yellow]Tip: Ensure GOLF_API_KEY and GOLF_SERVER_ID are available in your .env file[/yellow]"
+            )
+
     # Create a simple README
     readme_content = f"""# {settings.name}
 
@@ -1130,7 +1209,7 @@ This is a standalone FastMCP server generated by GolfMCP.
 
     # Copy pyproject.toml with required dependencies
     base_dependencies = [
-        "fastmcp>=2.0.0",
+        "fastmcp>=2.0.0,<2.6.0",
         "uvicorn>=0.20.0",
         "pydantic>=2.0.0",
         "python-dotenv>=1.0.0",

{golf_mcp-0.1.16 → golf_mcp-0.1.17}/src/golf/core/config.py

@@ -109,6 +109,12 @@ class Settings(BaseSettings):
     health_check_path: str = Field("/health", description="Health check endpoint path")
     health_check_response: str = Field("OK", description="Health check response text")
 
+    # HTTP session behaviour
+    stateless_http: bool = Field(
+        False,
+        description="Make Streamable-HTTP transport stateless (new session per request)",
+    )
+
 
 def find_config_path(start_path: Path | None = None) -> Path | None:
     """Find the golf config file by searching upwards from the given path.