VirSrSSKJr SSKrSSKJr SSKJrJrJ r J r J r J r SSK Jr SSKJr SSKJr \ "S \S 9r"S S \\\5r"S S\5r"SS\5r\\\-\-r"SS\5r\\-\-r\\\\4rSSjrSSjr SSjr!SSSjjr"SSSjjr#g)z&Elicitation utilities for MCP servers.) annotationsN)Sequence)GenericLiteralTypeVarUnionget_args get_origin) BaseModel) ServerSession) RequestIdElicitSchemaModelT)boundc2\rSrSr%SrSrS\S'S\S'Srg ) AcceptedElicitationz)Result when user accepts the elicitation.acceptLiteral['accept']actionrdataN__name__ __module__ __qualname____firstlineno____doc__r__annotations____static_attributes__ri/home/james-whalen/.local/share/pipx/venvs/semgrep/lib/python3.13/site-packages/mcp/server/elicitation.pyrrs3 (F ( r rc(\rSrSr%SrSrS\S'Srg)DeclinedElicitationz*Result when user declines the elicitation.declinezLiteral['decline']rrNrrr r!r#r#s4!*F *r r#c(\rSrSr%SrSrS\S'Srg)CancelledElicitationz)Result when user cancels the elicitation.cancelzLiteral['cancel']rrNrrr r!r'r's3 (F (r r'c(\rSrSr%SrSrS\S'Srg)AcceptedUrlElicitation'z0Result when user accepts a URL mode elicitation.rrrrNrrr r!r+r+'s: (F (r r+cURR5HaupURnUbU[RLaM)[ U5(aM;[ U5(aMM[SUS[S35e g)zCValidate that a Pydantic model only contains primitive field types.NzElicitation schema field 'z' must be a primitive type zw, a sequence of strings (list[str], etc.), or Optional of these types. Nested models and complex types are not allowed.) model_fieldsitems annotationtypesNoneType_is_primitive_field_is_string_sequence TypeError_ELICITATION_PRIMITIVE_TYPES)schema field_name field_infor0s r!_validate_elicitation_schemar:4s"("5"5";";"= **  u~~!=   , ,   , , ,ZL8S/01_` #>r c[U5nU(aC[U[5(a+[U5n[ U5S:H=(a US[ L$gg![ a gf=f)zMCheck if annotation is a sequence of strings (list[str], Sequence[str], etc).rF)r issubclassrr lenstrr5r0originargss r!r4r4Gsg  #F  &(++ +4yA~8$q'S.8,     s?A A$#A$cU[;ag[U5nU[LdU[RLa[ U5n[ SU55$g)zDCheck if a field is a primitive type allowed in elicitation schemas.Tc3# UH8o[RL=(d U[;=(d [U5v M: g7fN)r1r2r6r4).0args r! &_is_primitive_field..bs6 ptil5>> ! dS,H%H dL_`cLd dptsAAF)r6r rr1 UnionTyper allr@s r!r3r3WsW11 #F &EOO3 # pt    r c# [U5 UR5nURUUUS9IShvN nURS:Xa1URb$UR UR5n[ US9$URS:Xa [5$URS:Xa [5$[SUR35eN7f)a Elicit information from the client/user with schema validation (form mode). This method can be used to interactively ask for additional information from the client within a tool's execution. The client might display the message to the user and collect a response according to the provided schema. Or in case a client is an agent, it might decide how to handle the elicitation -- either by asking the user or automatically generating a response. For sensitive data like credentials or OAuth flows, use elicit_url() instead. )messagerequestedSchemarelated_request_idNr)rr%r)Unexpected elicitation action: ) r:model_json_schema elicit_formrcontentmodel_validaterr#r' ValueError)sessionrMr7rO json_schemaresultvalidated_datas r!elicit_with_validationrZis"!(**,K&&#-'F }} V^^%?..v~~>"77 ) #"$$ ( "#%%:6==/JKK!s0CCBCc# URUUUUS9IShvN nURS:Xa [5$URS:Xa [5$URS:Xa [ 5$[ SUR35eNj7f)aElicit information from the user via out-of-band URL navigation (URL mode). This method directs the user to an external URL where sensitive interactions can occur without passing data through the MCP client. Use this for: - Collecting sensitive credentials (API keys, passwords) - OAuth authorization flows with third-party services - Payment and subscription flows - Any interaction where data should not pass through the LLM context The response indicates whether the user consented to navigate to the URL. The actual interaction happens out-of-band. When the elicitation completes, the server should send an ElicitCompleteNotification to notify the client. Args: session: The server session message: Human-readable explanation of why the interaction is needed url: The URL the user should navigate to elicitation_id: Unique identifier for tracking this elicitation related_request_id: Optional ID of the request that triggered this elicitation Returns: UrlElicitationResult indicating accept, decline, or cancel )rMurlelicitation_idrONrr%r)rP) elicit_urlrr+r#r'rU)rVrMr\r]rOrXs r!r^r^s<%% %- &F}} %'' ) #"$$ ( "#%%:6==/JKKsBBA+B)r7ztype[BaseModel]returnNone)r0typer_boolrE) rVr rMr?r7ztype[ElicitSchemaModelT]rORequestId | Noner_z%ElicitationResult[ElicitSchemaModelT]) rVr rMr?r\r?r]r?rOrcr_UrlElicitationResult)$r __future__rr1collections.abcrtypingrrrrr r pydanticr mcp.server.sessionr mcp.typesr rrr#r'ElicitationResultr+rdr?intfloatrbr6r:r4r3rZr^rr r!rns<," $II,1C)W-?%@+)+ )9) ((:;>QQThh)Y) .0CCFZZ!$S%6&  ,,0 %L %L %L %%L) %L + %LZ,0 -L -L -L -L -L ) -L  -Lr