+ Q(iRt^RIHt^RIt^RIHt^RIHt^RIH t ^RI H t H t ] R,t ] !^R7t]!]P!4R,4tR t]!R R 44t]!R R 44tR#)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) timedelta)AnyLiteral)secondsii`c8]tRt^t$RtRtR]R&RtR]R&RtR#)TaskMetaaMMetadata for task-augmented execution requests. When passed to call_tool/read_resource/get_prompt, signals that the operation should be submitted as a background task. Attributes: ttl: Client-requested TTL in milliseconds. If None, uses server default. fn_key: Docket routing key. Auto-derived from component name if None. Nz int | Nonettlz str | Nonefn_key) __name__ __module__ __qualname____firstlineno____doc__r __annotations__r __static_attributes__r a/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/fastmcp/server/tasks/config.pyr r sCFJrr cf]tRt^(t$RtRtR]R&]tR]R&] RRl4t R R lt R R lt R t R#) TaskConfigamConfiguration 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. Important: Task-enabled components must be available at server startup to be registered with all Docket workers. Components added dynamically after startup will not be registered for background execution. 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(): ... ``` optionalTaskModemoder poll_intervalc V^8dQhRRRR/#)valueboolreturnrr )formats"r __annotate__TaskConfig.__annotate__Os > >d >z >rc 2T!V'dRR7#RR7#)zConvert boolean task flag to TaskConfig. Args: value: True for "optional" mode, False for "forbidden" mode. Returns: TaskConfig with appropriate mode. r forbiddenrr )clsrs&&r from_boolTaskConfig.from_boolNse ====rcV^8dQhRR/#)rr!r r )r"s"rr#r$Zs(((rc VPR8g#)zCheck if this component supports task execution. Returns: True if mode is "optional" or "required", False if "forbidden". r&r')selfs&rsupports_tasksTaskConfig.supports_tasksZs yyK''rc$V^8dQhRRRRRR/#)rfnzCallable[..., Any]namestrr!Noner )r"s"rr#r$bs"&&$6&c&d&rc jVP4'gR#^RIHpV!RV R24Tp\P!V4'g\ V4'd VP p\V\4'd VPp\P!V4'g\RV R24hR#)a*Validate that function is compatible with this task config. Task execution requires: 1. fastmcp[tasks] to be installed (pydocket) 2. Async functions Raises ImportError if mode is "optional" or "required" but pydocket is not installed. Raises ValueError if function is synchronous. Args: fn: The function to validate (handles callable classes and staticmethods). name: Name for error messages. Raises: ImportError: If task execution is enabled but pydocket not installed. ValueError: If task execution is enabled but function is sync. N)require_docketz`task=True` on function ''z`' uses a sync function but has task execution enabled. Background tasks require async functions.) r.fastmcp.server.dependenciesr6inspect isroutinecallable__call__ isinstance staticmethod__func__iscoroutinefunction ValueError)r-r1r2r6 fn_to_checks&&& rvalidate_functionTaskConfig.validate_functionbs$""$$  ?24&:;   $$"++K k< 0 0%..K**;77D6<< 8rr N)rrrrrrrDEFAULT_POLL_INTERVALr classmethodr)r.rCrr rrrr(s?B D(4M94 > >(&&rr)r&rrequired)r __future__rr9collections.abcr dataclassesrdatetimertypingrrrrEint total_secondsDEFAULT_POLL_INTERVAL_MSDEFAULT_TTL_MSr rr rrrQs #$! 6 7"!,4BBDtKL      __ _r