+ wi!Rt^RIHtHt^RIHtHt^RIHt^RI H t ^RI H t ^RI Ht^RIHt^RIHtHt^R IHtHtHtHtHtHtHtHtHtHt]!R R 44tR #) a  Experimental request context features. This module provides the Experimental class which gives access to experimental features within a request context, such as task-augmented request handling. WARNING: These APIs are experimental and may change without notice. ) AwaitableCallable) dataclassfield)Any)ServerTaskContext) TaskSupport) ServerSession)McpError)MODEL_IMMEDIATE_RESPONSE_KEY is_terminal) METHOD_NOT_FOUNDTASK_FORBIDDEN TASK_REQUIREDClientCapabilitiesCreateTaskResult ErrorDataResultTaskExecutionMode TaskMetadataToolc a]tRt^!toRtRt]!RRR7t]!RRR7t]!RRR7t ] V3RlRl4t ] V3RlRl4t R R /V3R lR llt R R /V3R lRlltV3RlRltRRRR/V3RlRlltV3RltRtVtR#) Experimentalz Experimental features context for task-augmented requests. Provides helpers for validating task execution compatibility and running tasks with automatic lifecycle management. WARNING: This API is experimental and may change without notice. NF)defaultreprc <V^8dQhRS[/#returnbool)format __classdict__s"[/home/ubuntu/.local/lib/python3.14/site-packages/mcp/server/experimental/request_context.py __annotate__Experimental.__annotate__2s...c VPRJ#)z(Check if this request is task-augmented.N) task_metadataselfs&r#is_taskExperimental.is_task1s!!--r&c <V^8dQhRS[/#rr)r!r"s"r#r$r%7s;;t;r&c RVPfR#VPPRJ#)z*Check if the client declared task support.NF)_client_capabilitiestasksr)s&r#client_supports_tasks"Experimental.client_supports_tasks6s*  $ $ ,((..d::r& raise_errorTcH<V^8dQhRS[R,RS[RS[R,/#)rtool_task_modeNr3r)rr r)r!r"s"r#r$r%=s3,,)D0, , T  ,r&c T;'g\pRpV\8Xd%VP'g\\RR7pM.V\8Xd$VP'd\\RR7pVeV'd \ V4hV#)a| Validate that the request is compatible with the tool's task execution mode. Per MCP spec: - "required": Clients MUST invoke as task. Server returns -32601 if not. - "forbidden" (or None): Clients MUST NOT invoke as task. Server returns -32601 if they do. - "optional": Either is acceptable. Args: tool_task_mode: The tool's execution.taskSupport value ("forbidden", "optional", "required", or None) raise_error: If True, raises McpError on validation failure. If False, returns ErrorData. Returns: None if valid, ErrorData if invalid and raise_error=False Raises: McpError: If invalid and raise_error=True Nz,This tool requires task-augmented invocation)codemessagez4This tool does not support task-augmented invocation)rrr+rr r )r*r5r3modeerrors&&$ r#validate_task_modeExperimental.validate_task_mode=sq4//"& = %FE^ # %NE  5/ ! r&c:<V^8dQhRS[RS[RS[R,/#)rtoolr3rN)rr r)r!r"s"r#r$r%ks3FFF F T  Fr&c zVP'dVPPMRpVPW2R7#)a? Validate that the request is compatible with the given tool. Convenience wrapper around validate_task_mode that extracts the mode from a Tool. Args: tool: The Tool definition raise_error: If True, raises McpError on validation failure. Returns: None if valid, ErrorData if invalid and raise_error=False N)r3) execution taskSupportr;)r*r>r3r9s&&$ r#validate_for_toolExperimental.validate_for_toolks1$.2^^^t~~))&&t&EEr&c4<V^8dQhRS[R,RS[/#)rr5Nr)rr )r!r"s"r#r$r%s!+\Nt \N #&* \N  \Nr&c ,aa "VPf \R4hVPf \R4hVPf \R4hVPpVPpVP P VPV4GRjxL p\VVP VPVPVPR7o RV V3RllpVPV4RpVe \V/p\R RV/V'dR V/B#/B#L5i) a[ Create a task, spawn background work, and return CreateTaskResult immediately. This is the recommended way to handle task-augmented tool calls. It: 1. Creates a task in the store 2. Spawns the work function in a background task 3. Returns CreateTaskResult immediately The work function receives a ServerTaskContext with: - elicit() for sending elicitation requests - create_message() for sampling requests - update_status() for progress updates - complete()/fail() for finishing the task When work() returns a Result, the task is auto-completed with that result. If work() raises an exception, the task is auto-failed. Args: work: Async function that does the actual work task_id: Optional task ID (generated if not provided) model_immediate_response: Optional string to include in _meta as io.modelcontextprotocol/model-immediate-response Returns: CreateTaskResult to return to the client Raises: RuntimeError: If task support is not enabled or task_metadata is missing Example: @server.call_tool() async def handle_tool(name: str, args: dict): ctx = server.request_context async def work(task: ServerTaskContext) -> CallToolResult: result = await task.elicit( message="Are you sure?", requestedSchema={"type": "object", ...} ) confirmed = result.content.get("confirm", False) return CallToolResult(content=[TextContent(text="Done" if confirmed else "Cancelled")]) return await ctx.experimental.run_task(work) WARNING: This API is experimental and may change without notice. NzHTask support not enabled. Call server.experimental.enable_tasks() first.zSession not available.zgRequest is not task-augmented (no task field in params). The client must send a task-augmented request.)taskstoresessionqueuehandlercV^8dQhRR/#)rrN)r!s"r#r$+Experimental.run_task..__annotate__s 0 0t 0r&c<"S!S4GRjxL p\SPP4'gSPV4GRjxL R#R#LFL \dZp\SPP4'g*SP \ T44GRjxL Rp?R#Rp?R#Rp?ii;i5i)N)r rNstatuscomplete ExceptionfailrL)resultetask_ctxrKs r#execute&Experimental.run_task..executes 0#H~-"8==#7#788"++F3339.3 0"8==#7#788"--A///9 0s]C AA=AAACAA B?&AB:(B+)B:. C:B??CrN_metarT) _task_support RuntimeError_sessionr( task_grouprO create_taskrrQrR start_soonr r) r*rKrHrIsupportrdrNr^metar]s &f$$ @r#run_taskExperimental.run_tasks j    %ij j == 78 8    %A  $$'' ]]..t/A/A7KK$--MM--OO   0 0 g&&* # /02JKDMTMgt_MM"MM3LsB DDBDc<V^8dQh/S[R,;R&S[R,;R&S[R,;R&S[R,;R&#)rNr(r/rcra)rrr r)r!r"s"r#r$r%!sM $&--t3Ud"D%Gr&rT)__name__ __module__ __qualname____firstlineno____doc__r(rr/rcrapropertyr+r1r;rBrFri__annotate_func____static_attributes____classdictcell__)r"s@r#rr!s*.M6;Du6U%*4e%DH(-d(GM ..;; ,! ,,\F! FF*$\N# \N 04 \N\Ncr&rN) rpcollections.abcrr dataclassesrrtypingr$mcp.server.experimental.task_contextr$mcp.server.experimental.task_supportrmcp.server.sessionr mcp.shared.exceptionsr %mcp.shared.experimental.tasks.helpersr r mcp.typesr rrrrrrrrrrrTr&r#r~sR0(B<,*[    LNLN LNr&