From 19fc972c4a19a63f5537bbdba71c4651711c1c39 Mon Sep 17 00:00:00 2001 From: Felix Weinberger Date: Thu, 25 Jun 2026 13:48:27 +0000 Subject: [PATCH] docs(core): mark elicitationId / ElicitationCompleteNotification* as @deprecated (spec #2891) The neutral schemas keep these (2025-era URL-mode flow still uses them); the 2026-07-28 wire codec already excludes the notification. Per the project rule: neutral schemas never drop, only @deprecated; per-revision strictness lives in the wire/rev*/ forks. --- packages/core/src/types/schemas.ts | 15 +++++++++++++++ packages/core/src/types/types.ts | 2 ++ 2 files changed, 17 insertions(+) diff --git a/packages/core/src/types/schemas.ts b/packages/core/src/types/schemas.ts index 2ebf045de..9ea304841 100644 --- a/packages/core/src/types/schemas.ts +++ b/packages/core/src/types/schemas.ts @@ -1973,6 +1973,11 @@ export const ElicitRequestURLParamsSchema = TaskAugmentedRequestParamsSchema.ext /** * The ID of the elicitation, which must be unique within the context of the server. * The client MUST treat this ID as an opaque value. + * + * @deprecated Removed from the spec by #2891 (2026-07-28). The client learns the + * outcome of an out-of-band interaction by retrying the original request; no + * server-initiated completion signal exists in the 2026-07-28 revision. Kept here + * for the 2025-era URL-mode flow only. */ elicitationId: z.string(), /** @@ -1999,11 +2004,17 @@ export const ElicitRequestSchema = RequestSchema.extend({ /** * Parameters for a {@linkcode ElicitationCompleteNotification | notifications/elicitation/complete} notification. * + * @deprecated Removed from the spec by #2891 (2026-07-28). The client learns the outcome + * of an out-of-band interaction by retrying the original request; no server-initiated + * completion signal exists in the 2026-07-28 revision. Kept here for the 2025-era flow + * only. The 2026-07-28 wire codec excludes this notification. * @category notifications/elicitation/complete */ export const ElicitationCompleteNotificationParamsSchema = NotificationsParamsSchema.extend({ /** * The ID of the elicitation that completed. + * + * @deprecated See {@linkcode ElicitationCompleteNotificationParamsSchema}. */ elicitationId: z.string() }); @@ -2011,6 +2022,10 @@ export const ElicitationCompleteNotificationParamsSchema = NotificationsParamsSc /** * A notification from the server to the client, informing it of a completion of an out-of-band elicitation request. * + * @deprecated Removed from the spec by #2891 (2026-07-28). The client learns the outcome + * of an out-of-band interaction by retrying the original request; no server-initiated + * completion signal exists in the 2026-07-28 revision. Kept here for the 2025-era flow + * only. The 2026-07-28 wire codec excludes this notification. * @category notifications/elicitation/complete */ export const ElicitationCompleteNotificationSchema = NotificationSchema.extend({ diff --git a/packages/core/src/types/types.ts b/packages/core/src/types/types.ts index 3c349286d..d61b43bd0 100644 --- a/packages/core/src/types/types.ts +++ b/packages/core/src/types/types.ts @@ -533,7 +533,9 @@ export type ElicitRequestParams = Infer; export type ElicitRequestFormParams = Infer; export type ElicitRequestURLParams = Infer; export type ElicitRequest = Infer; +/** @deprecated Removed from the spec by #2891 (2026-07-28). 2025-era only; the 2026-07-28 wire codec excludes this notification. */ export type ElicitationCompleteNotificationParams = Infer; +/** @deprecated Removed from the spec by #2891 (2026-07-28). 2025-era only; the 2026-07-28 wire codec excludes this notification. */ export type ElicitationCompleteNotification = Infer; export type ElicitResult = StripWireOnly>;