fix(model): decode metadata-bearing input-required results affecting mrtr (#1097)

* fix(model): decode metadata-bearing input-required results

  The draft permits every Result, including InputRequiredResult, to carry
  _meta and recommends that servers include
  io.modelcontextprotocol/serverInfo on every response. It also requires
  an InputRequiredResult to contain inputRequests or requestState so the
  client knows what to provide or how to resume the request.

  ServerResult uses untagged deserialization and attempts CallToolResult
  before InputRequiredResult. Because CallToolResult accepts _meta and
  defaults missing content to an empty list, it consumed valid
  input_required results carrying metadata. Unknown inputRequests and
  requestState fields were then discarded, leaving clients without the
  information needed to continue.

  Reject resultType input_required when deserializing CallToolResult so
  Serde proceeds to the InputRequiredResult variant. Add regression
  coverage proving that inputRequests, requestState, and serverInfo
  metadata are preserved.

  Spec:
  41d9e938e9/schema/draft/schema.ts (L137-L151)
  41d9e938e9/schema/draft/schema.ts (L198-L224)
  41d9e938e9/schema/draft/schema.ts (L541-L565)

Signed-off-by: Filinto Duran <1373693+filintod@users.noreply.github.com>

* incorporate feedback - close gap in inputrequired not properly checking that at least one of inputRequest or requestState is present

Signed-off-by: Filinto Duran <1373693+filintod@users.noreply.github.com>

---------

Signed-off-by: Filinto Duran <1373693+filintod@users.noreply.github.com>
This commit is contained in:
Filinto Duran 2026-07-31 08:23:56 -05:00 • committed by GitHub
commit 00bcf13800
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
3 changed files with 106 additions and 0 deletions

View file

@ -3814,6 +3814,8 @@ pub struct CallToolResult {
// 2. Requires at least one known field to be present, so that `CallToolResult` doesn't
// greedily match arbitrary JSON objects when used inside `#[serde(untagged)]` enums
// (e.g. `ServerResult`), which would shadow `CustomResult`.
// 3. Rejects `resultType: "input_required"` so untagged `ServerResult`
// decoding selects `InputRequiredResult` and preserves input requests and state.
impl<'de> Deserialize<'de> for CallToolResult {
fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
where
@ -3833,6 +3835,16 @@ impl<'de> Deserialize<'de> for CallToolResult {
let helper = Helper::deserialize(deserializer)?;
if helper
.result_type
.as_ref()
.is_some_and(ResultType::is_input_required)
{
return Err(serde::de::Error::custom(
"CallToolResult cannot use resultType \"input_required\"",
));
}
if helper.content.is_none()
&& helper.structured_content.is_none()
&& helper.is_error.is_none()

View file

@ -274,6 +274,12 @@ impl<'de> Deserialize<'de> for InputRequiredResult {
}
}
if helper.input_requests.is_none() && helper.request_state.is_none() {
return Err(serde::de::Error::custom(
"InputRequiredResult requires at least one of inputRequests or requestState",
));
}
Ok(InputRequiredResult {
result_type: ResultType::INPUT_REQUIRED,
input_requests: helper.input_requests,
@ -451,6 +457,19 @@ mod tests {
);
}
#[test]
fn rejects_missing_input_requests_and_request_state() {
let json = serde_json::json!({
"resultType": "input_required",
"_meta": {}
});
let err = serde_json::from_value::<InputRequiredResult>(json).unwrap_err();
assert!(
err.to_string().contains("inputRequests or requestState"),
"error should mention the required continuation fields, got: {err}"
);
}
#[test]
fn rejects_missing_result_type() {
let json = serde_json::json!({

View file

@ -70,6 +70,81 @@ mod untagged_server_result {
);
}
#[test]
fn input_required_result_with_meta_deserializes_to_correct_variant() {
let result = parse_result(wrap_response(json!({
"resultType": "input_required",
"inputRequests": {
"username": {
"method": "elicitation/create",
"params": {
"message": "Please provide your username",
"requestedSchema": {
"type": "object",
"properties": {
"username": { "type": "string" }
},
"required": ["username"]
}
}
}
},
"requestState": "opaque-state",
"_meta": {
"io.modelcontextprotocol/serverInfo": {
"name": "test-server",
"version": "1.0.0"
}
}
})));
let ServerResult::InputRequiredResult(result) = result else {
panic!("expected InputRequiredResult, got {result:?}");
};
assert!(
result.input_requests.is_some_and(|requests| {
requests.len() == 1 && requests.contains_key("username")
})
);
assert_eq!(result.request_state.as_deref(), Some("opaque-state"));
assert_eq!(
result
.meta
.as_ref()
.and_then(|meta| meta.get("io.modelcontextprotocol/serverInfo")),
Some(&json!({
"name": "test-server",
"version": "1.0.0"
}))
);
}
#[test]
fn call_tool_result_rejects_input_required_discriminator() {
assert!(
serde_json::from_value::<CallToolResult>(json!({
"resultType": "input_required",
"requestState": "opaque-state",
"_meta": {}
}))
.is_err()
);
}
#[test]
fn invalid_input_required_result_falls_through_to_custom_result() {
let payload = json!({
"resultType": "input_required",
"_meta": {}
});
let result = parse_result(wrap_response(payload.clone()));
let ServerResult::CustomResult(result) = result else {
panic!("expected CustomResult, got {result:?}");
};
assert_eq!(result.0, payload);
}
#[test]
fn empty_object_deserializes_to_empty_result() {
let result = parse_result(wrap_response(json!({})));