Merge branch 'main' into ihrpr/elicitation

src/shared/metadataUtils.ts

@@ -0,0 +1,36 @@
+import { BaseMetadata } from "../types.js";
+
+/**
+ * Utilities for working with BaseMetadata objects.
+ */
+
+/**
+ * Gets the display name for an object with BaseMetadata.
+ * For tools, the precedence is: title → annotations.title → name
+ * For other objects: title → name
+ * This implements the spec requirement: "if no title is provided, name should be used for display purposes"
+ */
+export function getDisplayName(metadata: BaseMetadata): string {
+  // First check for title (not undefined and not empty string)
+  if (metadata.title !== undefined && metadata.title !== '') {
+    return metadata.title;
+  }
+  
+  // Then check for annotations.title (only present in Tool objects)
+  if ('annotations' in metadata) {
+    const metadataWithAnnotations = metadata as BaseMetadata & { annotations?: { title?: string } };
+    if (metadataWithAnnotations.annotations?.title) {
+      return metadataWithAnnotations.annotations.title;
+    }
+  }
+  
+  // Finally fall back to name
+  return metadata.name;
+}
+
+/**
+ * Checks if an object has a custom title different from its name.
+ */
+export function hasCustomTitle(metadata: BaseMetadata): boolean {
+  return metadata.title !== undefined && metadata.title !== metadata.name;
+}

src/shared/transport.ts

@@ -75,4 +75,9 @@ export interface Transport {
    * The session ID generated for this connection.
    */
   sessionId?: string;
+
+  /**
+   * Sets the protocol version used for the connection (called when the initialize response is received).
+   */
+  setProtocolVersion?: (version: string) => void;
 }