Ki ldZddlmZddlZddlmZddlmZddlm Z m Z e dZ eGdd Z y) zTaskConfig for MCP SEP-1686 background task execution modes. This module defines the configuration for how tools, resources, and prompts handle task-augmented execution as specified in SEP-1686. ) annotationsN)Callable) dataclass)AnyLiteral) forbiddenoptionalrequiredc:eZdZUdZdZded<eddZd dZy) TaskConfigaConfiguration for MCP background task execution (SEP-1686). Controls how a component handles task-augmented requests: - "forbidden": Component does not support task execution. Clients must not request task augmentation; server returns -32601 if they do. - "optional": Component supports both synchronous and task execution. Client may request task augmentation or call normally. - "required": Component requires task execution. Clients must request task augmentation; server returns -32601 if they don't. Example: ```python from fastmcp import FastMCP from fastmcp.server.tasks import TaskConfig mcp = FastMCP("MyServer") # Background execution required @mcp.tool(task=TaskConfig(mode="required")) async def long_running_task(): ... # Supports both modes (default when task=True) @mcp.tool(task=TaskConfig(mode="optional")) async def flexible_task(): ... ``` r TaskModemodec&||rdSdS)zConvert boolean task flag to TaskConfig. Args: value: True for "optional" mode, False for "forbidden" mode. Returns: TaskConfig with appropriate mode. r r)r)clsvalues g/home/jay/workspace/scripts/.codegraph-venv/lib/python3.12/site-packages/fastmcp/server/tasks/config.py from_boolzTaskConfig.from_bool2se ====c|jdk(ry|}tj|st|r |j}t |t r |j}tj|std|dy)aValidate that function is compatible with this task config. Task execution requires async functions. Raises ValueError if mode is "optional" or "required" but function is synchronous. Args: fn: The function to validate (handles callable classes and staticmethods). name: Name for error messages. Raises: ValueError: If task execution is enabled but function is sync. rN'z`' uses a sync function but has task execution enabled. Background tasks require async functions.) rinspect isroutinecallable__call__ isinstance staticmethod__func__iscoroutinefunction ValueError)selffnname fn_to_checks rvalidate_functionzTaskConfig.validate_function>s} 99 #    $"++K k< 0%..K**;7D6<< 8rN)rboolreturnr )r"zCallable[..., Any]r#strr'None) __name__ __module__ __qualname____doc__r__annotations__ classmethodrr%rrrr r s*8 D( > >rr ) r- __future__rrcollections.abcr dataclassesrtypingrrr r rrrr4sD #$! 6 7 FF Fr