From 4044ac0f2e1fc824886ba8fd5fe37d7d2e0c6fcd Mon Sep 17 00:00:00 2001 From: Peter Alexander Date: Thu, 18 Jun 2026 16:05:24 +0100 Subject: [PATCH] docs: sync sep-2549 traceability with spec PR #2890 Updates SEP-2549 caching traceability text to match modelcontextprotocol/modelcontextprotocol#2890: - Scope the five *-caching-hints requirements to results with resultType: "complete" (interim input_required results carry no hints). - Add two excluded client MUST NOT rows from the new Cache Key section (cache-key mismatch, multi round-trip retry results). Neither is wire-observable since a conformant client may simply never cache. No check IDs change; traceability.json will be refreshed by the scheduled traceability workflow. Claude-Session: https://claude.ai/code/session_01Gbqx5LodtAghT5fRYFxeja --- src/seps/sep-2549.yaml | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/src/seps/sep-2549.yaml b/src/seps/sep-2549.yaml index 75f76e69..4a5c1a50 100644 --- a/src/seps/sep-2549.yaml +++ b/src/seps/sep-2549.yaml @@ -2,15 +2,15 @@ sep: 2549 spec_url: https://modelcontextprotocol.io/specification/draft/server/utilities/caching requirements: - check: sep-2549-tools-list-caching-hints - text: 'Servers MUST include caching hints on results returned by tools/list' + text: 'Servers MUST include caching hints on results with resultType: "complete" returned by tools/list' - check: sep-2549-prompts-list-caching-hints - text: 'Servers MUST include caching hints on results returned by prompts/list' + text: 'Servers MUST include caching hints on results with resultType: "complete" returned by prompts/list' - check: sep-2549-resources-list-caching-hints - text: 'Servers MUST include caching hints on results returned by resources/list' + text: 'Servers MUST include caching hints on results with resultType: "complete" returned by resources/list' - check: sep-2549-resources-templates-list-caching-hints - text: 'Servers MUST include caching hints on results returned by resources/templates/list' + text: 'Servers MUST include caching hints on results with resultType: "complete" returned by resources/templates/list' - check: sep-2549-resources-read-caching-hints - text: 'Servers MUST include caching hints on results returned by resources/read' + text: 'Servers MUST include caching hints on results with resultType: "complete" returned by resources/read' - check: sep-2549-ttl-non-negative text: 'Servers MUST provide a ttlMs value that is >= 0' - check: sep-2549-cache-scope-valid @@ -42,3 +42,7 @@ requirements: excluded: 'Server-side awareness requirement; implementation guidance not testable via protocol messages' - text: 'Server implementors MUST apply appropriate per-primitive access controls, and MUST NOT rely on cacheScope alone to prevent unauthorized access to primitives.' excluded: 'Server-side access control; implementation guidance not testable via protocol messages' + - text: 'Clients MUST NOT serve a cached response for a request whose method or parameters differ from the request that produced it.' + excluded: 'Client-side caching behavior; not observable at the protocol level' + - text: 'Results produced by retrying a request through the multi round-trip requests mechanism (requests carrying inputResponses or requestState) MUST NOT be cached.' + excluded: 'Client-side caching behavior; not observable at the protocol level'