import type { ElicitRequest, ElicitResult, } from "@modelcontextprotocol/sdk/types.js"; import { RELATED_TASK_META_KEY } from "@modelcontextprotocol/sdk/types.js"; export type { ElicitRequest, ElicitResult }; /** * Data shape of a pending elicitation request tracked by the InspectorClient. * v2's state/screen layer consumes this interface; the runtime class below * (ElicitationCreateMessage) implements it. */ export interface InspectorPendingElicitation { id: string; timestamp: Date; request: ElicitRequest; taskId?: string; } /** * Represents a pending elicitation request from the server */ export class ElicitationCreateMessage { public readonly id: string; public readonly timestamp: Date; public readonly request: ElicitRequest; public readonly taskId?: string; private resolvePromise?: (result: ElicitResult) => void; /** Set only for task-augmented elicit; used when user declines so server's tasks/result receives an error */ private rejectCallback?: (error: Error) => void; private onRemove: (id: string) => void; constructor( request: ElicitRequest, resolve: (result: ElicitResult) => void, onRemove: (id: string) => void, reject?: (error: Error) => void, ) { this.onRemove = onRemove; this.id = `elicitation-${crypto.randomUUID()}`; this.timestamp = new Date(); this.request = request; // Extract taskId from request params metadata if present const relatedTask = request.params?._meta?.[RELATED_TASK_META_KEY]; this.taskId = relatedTask?.taskId; this.resolvePromise = resolve; this.rejectCallback = reject; } /** * Reject the elicitation (e.g. when user declines). Only has effect when this * request was task-augmented; then the server's tasks/result will receive the error. */ reject(error: Error): void { if (this.rejectCallback) { this.rejectCallback(error); this.rejectCallback = undefined; } } /** * Respond to the elicitation request with a result */ async respond(result: ElicitResult): Promise { if (!this.resolvePromise) { throw new Error("Request already resolved"); } this.resolvePromise(result); this.resolvePromise = undefined; // Remove from pending list after responding this.remove(); } /** * Remove this pending elicitation from the list */ remove(): void { this.onRemove(this.id); } }