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;
}