elicitation 0.10.0

Conversational elicitation of strongly-typed Rust values via MCP
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

//! `reqwest::RequestBuilder` elicitation (Survey pattern).
//!
//! Elicits an HTTP method and URL, then constructs a `RequestBuilder` via
//! `RequestBuilder::from_parts(Client::new(), Request::new(method, url))`.
//! This makes mock request builders trivially available to agents for testing.

use crate::{
    ElicitCommunicator, ElicitIntrospect, ElicitResult, Elicitation, ElicitationPattern,
    PatternDetails, Prompt, TypeMetadata,
};
use reqwest::{Client, Request, RequestBuilder};
use url::Url;

crate::default_style!(RequestBuilder => RequestBuilderStyle);

impl Prompt for RequestBuilder {
    fn prompt() -> Option<&'static str> {
        Some(
            "Construct an HTTP request builder — provide the method and target URL. \
             Additional configuration (headers, body, timeout) can be applied via \
             subsequent builder method calls.",
        )
    }
}

impl Elicitation for RequestBuilder {
    type Style = RequestBuilderStyle;

    #[tracing::instrument(skip(communicator))]
    async fn elicit<C: ElicitCommunicator>(communicator: &C) -> ElicitResult<Self> {
        tracing::debug!("Eliciting reqwest::RequestBuilder");

        let method = reqwest::Method::elicit(communicator).await?;
        tracing::debug!(?method, "Method selected");

        let url = Url::elicit(communicator).await?;
        tracing::debug!(%url, "URL selected");

        let request = Request::new(method, url);
        Ok(RequestBuilder::from_parts(Client::new(), request))
    }

    fn kani_proof() -> proc_macro2::TokenStream {
        crate::verification::proof_helpers::kani_trusted_opaque("request_builder")
    }

    fn verus_proof() -> proc_macro2::TokenStream {
        crate::verification::proof_helpers::verus_trusted_opaque("request_builder")
    }

    fn creusot_proof() -> proc_macro2::TokenStream {
        crate::verification::proof_helpers::creusot_trusted_opaque("request_builder")
    }
}

impl ElicitIntrospect for RequestBuilder {
    fn pattern() -> ElicitationPattern {
        ElicitationPattern::Survey
    }

    fn metadata() -> TypeMetadata {
        TypeMetadata {
            type_name: "reqwest::RequestBuilder",
            description: Self::prompt(),
            details: PatternDetails::Survey {
                fields: vec![
                    crate::FieldInfo {
                        name: "method",
                        type_name: "reqwest::Method",
                        prompt: Some("HTTP method (GET, POST, …)"),
                    },
                    crate::FieldInfo {
                        name: "url",
                        type_name: "url::Url",
                        prompt: Some("Target URL"),
                    },
                ],
            },
        }
    }
}