fix: typescript types to be compatible with MCP SDK

packages/server/src/index.ts

@@ -5,7 +5,10 @@
 
 // Import types first
 import {
+  Base64BlobContent,
   CreateHtmlResourceOptions,
+  HtmlTextContent,
+  MimeType,
   UiActionResult,
   UiActionResultLink,
   UiActionResultNotification,
@@ -14,15 +17,10 @@ import {
   UiActionResultToolCall,
 } from './types.js';
 
-export interface HtmlResourceBlock {
+export type HtmlResourceBlock = {
   type: 'resource';
-  resource: {
-    uri: string; // Primary identifier. Starts with "ui://"
-    mimeType: 'text/html' | 'text/uri-list'; // text/html for rawHtml content, text/uri-list for externalUrl content
-    text?: string; // HTML content (for mimeType `text/html`), or iframe URL (for mimeType `text/uri-list`)
-    blob?: string; // Base64 encoded HTML content (for mimeType `text/html`), or iframe URL (for mimeType `text/uri-list`)
-  };
-}
+  resource: HtmlTextContent | Base64BlobContent;
+};
 
 /**
  * Robustly encodes a UTF-8 string to Base64.
@@ -68,7 +66,7 @@ export function createHtmlResource(
   options: CreateHtmlResourceOptions,
 ): HtmlResourceBlock {
   let actualContentString: string;
-  let mimeType: 'text/html' | 'text/uri-list';
+  let mimeType: MimeType;
 
   if (options.content.type === 'rawHtml') {
     if (!options.uri.startsWith('ui://')) {
@@ -104,18 +102,29 @@ export function createHtmlResource(
     );
   }
 
-  const resource: HtmlResourceBlock['resource'] = {
-    uri: options.uri,
-    mimeType: mimeType,
-  };
+  let resource: HtmlResourceBlock['resource'];
 
   switch (options.delivery) {
     case 'text':
-      resource.text = actualContentString;
+      resource = {
+        uri: options.uri,
+        mimeType: mimeType,
+        text: actualContentString,
+      };
       break;
     case 'blob':
-      resource.blob = robustUtf8ToBase64(actualContentString);
+      resource = {
+        uri: options.uri,
+        mimeType: mimeType,
+        blob: robustUtf8ToBase64(actualContentString),
+      };
       break;
+    default:
+      // Exhaustive check
+      (() => {
+        const exhaustiveCheck: never = options.delivery;
+        throw new Error(`Invalid delivery type: ${exhaustiveCheck}`);
+      })();
   }
 
   return {
@@ -166,9 +175,7 @@ export function uiActionResultToolCall(
   };
 }
 
-export function uiActionResultPrompt(
-  prompt: string,
-): UiActionResultPrompt {
+export function uiActionResultPrompt(prompt: string): UiActionResultPrompt {
   return {
     type: 'prompt',
     payload: {
@@ -202,10 +209,10 @@ export function uiActionResultIntent(
 export function uiActionResultNotification(
   message: string,
 ): UiActionResultNotification {
-  return {  
+  return {
     type: 'notification',
     payload: {
       message,
     },
   };
-}
+}

packages/server/src/types.ts

@@ -1,15 +1,40 @@
+// Primary identifier for the resource. Starts with ui://`
+export type URI = `ui://${string}`;
+
+// text/html for rawHtml content, text/uri-list for externalUrl content
+export type MimeType = 'text/html' | 'text/uri-list';
+
+export type HtmlTextContent = {
+  uri: URI;
+  mimeType: MimeType;
+  text: string; // HTML content (for mimeType `text/html`), or iframe URL (for mimeType `text/uri-list`)
+  blob?: never;
+};
+
+export type Base64BlobContent = {
+  uri: URI;
+  mimeType: MimeType;
+  blob: string; //  Base64 encoded HTML content (for mimeType `text/html`), or iframe URL (for mimeType `text/uri-list`)
+  text?: never;
+};
+
 export type ResourceContentPayload =
   | { type: 'rawHtml'; htmlString: string }
   | { type: 'externalUrl'; iframeUrl: string };
 
 export interface CreateHtmlResourceOptions {
-  uri: string; // REQUIRED. Must start with "ui://" if content.type is "rawHtml",
+  uri: URI; // REQUIRED. Must start with "ui://" if content.type is "rawHtml",
   // or "ui-app://" if content.type is "externalUrl".
   content: ResourceContentPayload; // REQUIRED. The actual content payload.
   delivery: 'text' | 'blob'; // REQUIRED. How the content string (htmlString or iframeUrl) should be packaged.
 }
 
-export type UiActionType = 'tool' | 'prompt' | 'link' | 'intent' | 'notification';
+export type UiActionType =
+  | 'tool'
+  | 'prompt'
+  | 'link'
+  | 'intent'
+  | 'notification';
 
 export type UiActionResultToolCall = {
   type: 'tool';