skybridge 0.0.0-dev.fe84ef2 → 0.0.0-dev.fefabd5

package/dist/{src/server → server}/templateHelper.js

@@ -1,14 +1,15 @@
-import Handlebars from "handlebars";
 import { readFileSync } from "node:fs";
-import { join, dirname } from "node:path";
+import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
+import Handlebars from "handlebars";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 class TemplateHelper {
     templateCache = new Map();
     loadTemplate(templateName) {
-        if (this.templateCache.has(templateName)) {
-            return this.templateCache.get(templateName);
+        const cached = this.templateCache.get(templateName);
+        if (cached) {
+            return cached;
         }
         const templatePath = join(__dirname, "templates", `${templateName}.hbs`);
         const templateSource = readFileSync(templatePath, "utf-8");

package/dist/server/templateHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateHelper.js","sourceRoot":"","sources":["../../src/server/templateHelper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,UAAU,MAAM,YAAY,CAAC;AAGpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,MAAM,cAAc;IACV,aAAa,GAAG,IAAI,GAAG,EAAsC,CAAC;IAE9D,YAAY,CAAC,YAAoB;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACpD,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,YAAY,MAAM,CAAC,CAAC;QACzE,MAAM,cAAc,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAEpD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAC/C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,gBAAgB,CAAC,IAKhB;QACC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QACjD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,iBAAiB,CAAC,IAKjB;QACC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;QAClD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC"}

package/dist/server/templates/development.hbs

@@ -0,0 +1,67 @@
+<script type="module">window.skybridge = { hostType: "{{hostType}}", serverUrl: "{{serverUrl}}" };</script>
+<script type="module">
+  import { injectIntoGlobalHook } from "{{serverUrl}}/assets/@react-refresh";
+  injectIntoGlobalHook(window); window.$RefreshReg$ = () => {};
+  window.$RefreshSig$ = () => (type) => type;
+  window.__vite_plugin_react_preamble_installed__ = true;
+</script>
+<script type="module" src="{{serverUrl}}/@vite/client"></script>
+{{#if useLocalNetworkAccess}}
+<script type="module">
+  // Checks for browser support and shows error if local network access is denied
+  (async () => {
+    if (!navigator.permissions?.query) {
+      return;
+    }
+
+    // Skip for non-http(s) protocols (file://, custom protocols in Electron, etc.)
+    const protocol = window.location.protocol;
+    const isNonHttpProtocol = protocol !== 'http:' && protocol !== 'https:'
+    if (isNonHttpProtocol) {
+      return;
+    }
+
+    const host = window.location.hostname;
+    const isLoopback = host === 'localhost'
+      || /^127\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.test(host)
+      || host === '::1';
+    if (isLoopback) {
+      return;
+    }
+    
+    try {
+      const status = await navigator.permissions.query({ name: "local-network-access" });
+      if (status.state === "denied") {
+        const errorDiv = document.createElement("div");
+        errorDiv.style.cssText = "background: #fef2f2; border: 2px solid #ef4444; border-radius: 8px; padding: 16px; text-align: center; z-index: 10000; font-family: system-ui, sans-serif;";
+
+        const errorTitle = document.createElement("div");
+        errorTitle.style.cssText = "color: #ef4444; font-size: 18px; font-weight: 600; margin-bottom: 8px;";
+        errorTitle.textContent = "Error: Local network access permission is denied.";
+
+        const errorMessage = document.createElement("div");
+        errorMessage.style.cssText = "color: #ef4444; font-size: 14px;";
+        errorMessage.textContent = "Local network access is required for your widget to connect to the local dev server. Please enable it in your browser settings. ";
+
+        const link = document.createElement("a");
+        link.href = "https://developer.chrome.com/blog/local-network-access";
+        link.target = "_blank";
+        link.rel = "noopener noreferrer";
+        link.style.cssText = "color: #ef4444; text-decoration: underline;";
+        link.textContent = "Learn more";
+        errorMessage.appendChild(link);
+
+        errorDiv.appendChild(errorTitle);
+        errorDiv.appendChild(errorMessage);
+        document.body.appendChild(errorDiv);
+      }
+    } catch (e) {
+      // Permission API doesn't support local-network-access, ignore silently
+    }
+  })();
+</script>
+{{/if}}
+<div id="root"></div>
+<script type="module" id="dev-widget-entry">
+  import('{{serverUrl}}/src/widgets/{{widgetName}}');
+</script>

package/dist/{src/server → server}/templates/production.hbs

@@ -1,4 +1,4 @@
-<base href="{{serverUrl}}" />
+<script type="module">window.skybridge = { hostType: "{{hostType}}", serverUrl: "{{serverUrl}}" };</script>
 <div id="root"></div>
 <script type="module">
   import('{{serverUrl}}/assets/{{widgetFile}}');

package/dist/{src/server → server}/widgetsDevServer.d.ts

@@ -1,4 +1,4 @@
-import { type RequestHandler } from "express";
+import { type Router } from "express";
 /**
  * Install Vite dev server
  * This router MUST be installed at the application root, like so:
@@ -9,4 +9,4 @@ import { type RequestHandler } from "express";
  *   app.use(await widgetsRouter());
  * }
  */
-export declare const widgetsDevServer: () => Promise<RequestHandler>;
+export declare const widgetsDevServer: () => Promise<Router>;

package/dist/server/widgetsDevServer.js

@@ -0,0 +1,57 @@
+import { existsSync } from "node:fs";
+import path from "node:path";
+import cors from "cors";
+import express, {} from "express";
+import { assetBaseUrlTransformPlugin } from "./asset-base-url-transform-plugin.js";
+/**
+ * Install Vite dev server
+ * This router MUST be installed at the application root, like so:
+ *
+ *  const app = express();
+ *
+ * if (env.NODE_ENV !== "production") {
+ *   app.use(await widgetsRouter());
+ * }
+ */
+export const widgetsDevServer = async () => {
+    const router = express.Router();
+    const { createServer, searchForWorkspaceRoot, loadConfigFromFile } = await import("vite");
+    // Since 0.16.0, the template is a single package that does not rely on workspace.
+    // It means that, when starting the server, the working dir is the template root
+    // hence we don't need to walk up the tree to find the workspace, which does not exist anymore.
+    let webAppRoot = path.join(process.cwd(), "web");
+    // fallback to the old behavior for backward compatibility
+    const hasWebAppRoot = existsSync(webAppRoot);
+    if (!hasWebAppRoot) {
+        const workspaceRoot = searchForWorkspaceRoot(process.cwd());
+        webAppRoot = path.join(workspaceRoot, "web");
+    }
+    const configResult = await loadConfigFromFile({ command: "serve", mode: "development" }, path.join(webAppRoot, "vite.config.ts"), webAppRoot);
+    const { build, preview, plugins: userPlugins = [], ...devConfig } = configResult?.config || {};
+    const vite = await createServer({
+        ...devConfig,
+        configFile: false, // Keep this to prevent vite from trying to resolve path in the target config file
+        appType: "custom",
+        server: {
+            allowedHosts: true,
+            middlewareMode: true,
+            hmr: {
+                protocol: "ws",
+                host: "localhost",
+                port: 24678,
+            },
+        },
+        root: webAppRoot,
+        optimizeDeps: {
+            include: ["react", "react-dom/client"],
+        },
+        plugins: [
+            ...userPlugins,
+            assetBaseUrlTransformPlugin({ devServerOrigin: "http://localhost:3000" }),
+        ],
+    });
+    router.use(cors());
+    router.use("/", vite.middlewares);
+    return router;
+};
+//# sourceMappingURL=widgetsDevServer.js.map

package/dist/server/widgetsDevServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgetsDevServer.js","sourceRoot":"","sources":["../../src/server/widgetsDevServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,OAAO,EAAE,EAAe,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AAEnF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,IAAqB,EAAE;IAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAEhC,MAAM,EAAE,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,GAChE,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAEvB,kFAAkF;IAClF,gFAAgF;IAChF,+FAA+F;IAC/F,IAAI,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;IAEjD,0DAA0D;IAC1D,MAAM,aAAa,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,aAAa,GAAG,sBAAsB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC5D,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,kBAAkB,CAC3C,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,EACzC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,EACvC,UAAU,CACX,CAAC;IAEF,MAAM,EACJ,KAAK,EACL,OAAO,EACP,OAAO,EAAE,WAAW,GAAG,EAAE,EACzB,GAAG,SAAS,EACb,GAAG,YAAY,EAAE,MAAM,IAAI,EAAE,CAAC;IAE/B,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC;QAC9B,GAAG,SAAS;QACZ,UAAU,EAAE,KAAK,EAAE,kFAAkF;QACrG,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE;YACN,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,IAAI;YACpB,GAAG,EAAE;gBACH,QAAQ,EAAE,IAAI;gBACd,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,KAAK;aACZ;SACF;QACD,IAAI,EAAE,UAAU;QAChB,YAAY,EAAE;YACZ,OAAO,EAAE,CAAC,OAAO,EAAE,kBAAkB,CAAC;SACvC;QACD,OAAO,EAAE;YACP,GAAG,WAAW;YACd,2BAA2B,CAAC,EAAE,eAAe,EAAE,uBAAuB,EAAE,CAAC;SAC1E;KACF,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACnB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAElC,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/test/utils.d.ts

@@ -0,0 +1,355 @@
+import { type MockInstance } from "vitest";
+import { McpServer } from "../server/server.js";
+/**
+ * Creates a real McpServer instance for testing
+ */
+export declare function createMockMcpServer(): {
+    server: McpServer;
+    mockRegisterResource: MockInstance<McpServer["registerResource"]>;
+    mockRegisterTool: MockInstance<McpServer["registerTool"]>;
+};
+export declare function createTestServer(): McpServer<Record<never, import("../server/server.js").ToolDef<unknown, unknown, unknown>> & {
+    "search-voyage": import("../server/server.js").ToolDef<{
+        destination: string;
+        departureDate?: string | undefined;
+        maxPrice?: number | undefined;
+    }, {
+        results: {
+            id: string;
+            name: string;
+            price: number;
+        }[];
+        totalCount: number;
+    }, unknown>;
+} & {
+    "get-trip-details": import("../server/server.js").ToolDef<{
+        tripId: string;
+    }, {
+        name: string;
+        description: string;
+        images: string[];
+    }, unknown>;
+} & {
+    "no-input-widget": import("../server/server.js").ToolDef<{}, {}, unknown>;
+} & {
+    "inferred-output-widget": import("../server/server.js").ToolDef<{
+        query: string;
+    }, {
+        inferredResults: {
+            id: string;
+            score: number;
+        }[];
+        inferredCount: number;
+    }, unknown>;
+} & {
+    "calculate-price": import("../server/server.js").ToolDef<{
+        tripId: string;
+        passengers: number;
+    }, {
+        totalPrice: number;
+        currency: string;
+    }, unknown>;
+} & {
+    "inferred-tool": import("../server/server.js").ToolDef<{
+        itemId: string;
+    }, {
+        itemDetails: {
+            name: string;
+            available: boolean;
+        };
+        fetchedAt: string;
+    }, unknown>;
+} & {
+    "widget-with-metadata": import("../server/server.js").ToolDef<{
+        resourceId: string;
+    }, {
+        data: {
+            id: string;
+            loaded: boolean;
+        };
+    }, {
+        requestId: string;
+        timestamp: number;
+        cached: boolean;
+    }>;
+} & {
+    "tool-with-metadata": import("../server/server.js").ToolDef<{
+        query: string;
+    }, {
+        results: string[];
+    }, {
+        executionTime: number;
+        source: string;
+    }>;
+} & {
+    "widget-with-mixed-returns": import("../server/server.js").ToolDef<{
+        shouldSucceed: boolean;
+    }, {
+        error: string;
+        data?: undefined;
+    } | {
+        data: string;
+        error?: undefined;
+    }, {
+        processedAt: number;
+        region: string;
+    }>;
+}> & {
+    use(...handlers: import("express").RequestHandler[]): McpServer<Record<never, import("../server/server.js").ToolDef<unknown, unknown, unknown>> & {
+        "search-voyage": import("../server/server.js").ToolDef<{
+            destination: string;
+            departureDate?: string | undefined;
+            maxPrice?: number | undefined;
+        }, {
+            results: {
+                id: string;
+                name: string;
+                price: number;
+            }[];
+            totalCount: number;
+        }, unknown>;
+    } & {
+        "get-trip-details": import("../server/server.js").ToolDef<{
+            tripId: string;
+        }, {
+            name: string;
+            description: string;
+            images: string[];
+        }, unknown>;
+    } & {
+        "no-input-widget": import("../server/server.js").ToolDef<{}, {}, unknown>;
+    } & {
+        "inferred-output-widget": import("../server/server.js").ToolDef<{
+            query: string;
+        }, {
+            inferredResults: {
+                id: string;
+                score: number;
+            }[];
+            inferredCount: number;
+        }, unknown>;
+    } & {
+        "calculate-price": import("../server/server.js").ToolDef<{
+            tripId: string;
+            passengers: number;
+        }, {
+            totalPrice: number;
+            currency: string;
+        }, unknown>;
+    } & {
+        "inferred-tool": import("../server/server.js").ToolDef<{
+            itemId: string;
+        }, {
+            itemDetails: {
+                name: string;
+                available: boolean;
+            };
+            fetchedAt: string;
+        }, unknown>;
+    } & {
+        "widget-with-metadata": import("../server/server.js").ToolDef<{
+            resourceId: string;
+        }, {
+            data: {
+                id: string;
+                loaded: boolean;
+            };
+        }, {
+            requestId: string;
+            timestamp: number;
+            cached: boolean;
+        }>;
+    } & {
+        "tool-with-metadata": import("../server/server.js").ToolDef<{
+            query: string;
+        }, {
+            results: string[];
+        }, {
+            executionTime: number;
+            source: string;
+        }>;
+    } & {
+        "widget-with-mixed-returns": import("../server/server.js").ToolDef<{
+            shouldSucceed: boolean;
+        }, {
+            error: string;
+            data?: undefined;
+        } | {
+            data: string;
+            error?: undefined;
+        }, {
+            processedAt: number;
+            region: string;
+        }>;
+    }> & /*elided*/ any;
+    use(path: string, ...handlers: import("express").RequestHandler[]): McpServer<Record<never, import("../server/server.js").ToolDef<unknown, unknown, unknown>> & {
+        "search-voyage": import("../server/server.js").ToolDef<{
+            destination: string;
+            departureDate?: string | undefined;
+            maxPrice?: number | undefined;
+        }, {
+            results: {
+                id: string;
+                name: string;
+                price: number;
+            }[];
+            totalCount: number;
+        }, unknown>;
+    } & {
+        "get-trip-details": import("../server/server.js").ToolDef<{
+            tripId: string;
+        }, {
+            name: string;
+            description: string;
+            images: string[];
+        }, unknown>;
+    } & {
+        "no-input-widget": import("../server/server.js").ToolDef<{}, {}, unknown>;
+    } & {
+        "inferred-output-widget": import("../server/server.js").ToolDef<{
+            query: string;
+        }, {
+            inferredResults: {
+                id: string;
+                score: number;
+            }[];
+            inferredCount: number;
+        }, unknown>;
+    } & {
+        "calculate-price": import("../server/server.js").ToolDef<{
+            tripId: string;
+            passengers: number;
+        }, {
+            totalPrice: number;
+            currency: string;
+        }, unknown>;
+    } & {
+        "inferred-tool": import("../server/server.js").ToolDef<{
+            itemId: string;
+        }, {
+            itemDetails: {
+                name: string;
+                available: boolean;
+            };
+            fetchedAt: string;
+        }, unknown>;
+    } & {
+        "widget-with-metadata": import("../server/server.js").ToolDef<{
+            resourceId: string;
+        }, {
+            data: {
+                id: string;
+                loaded: boolean;
+            };
+        }, {
+            requestId: string;
+            timestamp: number;
+            cached: boolean;
+        }>;
+    } & {
+        "tool-with-metadata": import("../server/server.js").ToolDef<{
+            query: string;
+        }, {
+            results: string[];
+        }, {
+            executionTime: number;
+            source: string;
+        }>;
+    } & {
+        "widget-with-mixed-returns": import("../server/server.js").ToolDef<{
+            shouldSucceed: boolean;
+        }, {
+            error: string;
+            data?: undefined;
+        } | {
+            data: string;
+            error?: undefined;
+        }, {
+            processedAt: number;
+            region: string;
+        }>;
+    }> & /*elided*/ any;
+    run(): Promise<void>;
+};
+export declare function createMinimalTestServer(): McpServer<Record<never, import("../server/server.js").ToolDef<unknown, unknown, unknown>> & {
+    "search-voyage": import("../server/server.js").ToolDef<{
+        destination: string;
+    }, {
+        results: {
+            id: string;
+        }[];
+    }, unknown>;
+}> & {
+    use(...handlers: import("express").RequestHandler[]): McpServer<Record<never, import("../server/server.js").ToolDef<unknown, unknown, unknown>> & {
+        "search-voyage": import("../server/server.js").ToolDef<{
+            destination: string;
+        }, {
+            results: {
+                id: string;
+            }[];
+        }, unknown>;
+    }> & /*elided*/ any;
+    use(path: string, ...handlers: import("express").RequestHandler[]): McpServer<Record<never, import("../server/server.js").ToolDef<unknown, unknown, unknown>> & {
+        "search-voyage": import("../server/server.js").ToolDef<{
+            destination: string;
+        }, {
+            results: {
+                id: string;
+            }[];
+        }, unknown>;
+    }> & /*elided*/ any;
+    run(): Promise<void>;
+};
+export declare function createInterfaceTestServer(): McpServer<Record<never, import("../server/server.js").ToolDef<unknown, unknown, unknown>> & {
+    "interface-widget": import("../server/server.js").ToolDef<{
+        id: string;
+    }, {
+        itemName: string;
+        quantity: number;
+    }, {
+        processedBy: string;
+        version: number;
+    }>;
+}> & {
+    use(...handlers: import("express").RequestHandler[]): McpServer<Record<never, import("../server/server.js").ToolDef<unknown, unknown, unknown>> & {
+        "interface-widget": import("../server/server.js").ToolDef<{
+            id: string;
+        }, {
+            itemName: string;
+            quantity: number;
+        }, {
+            processedBy: string;
+            version: number;
+        }>;
+    }> & /*elided*/ any;
+    use(path: string, ...handlers: import("express").RequestHandler[]): McpServer<Record<never, import("../server/server.js").ToolDef<unknown, unknown, unknown>> & {
+        "interface-widget": import("../server/server.js").ToolDef<{
+            id: string;
+        }, {
+            itemName: string;
+            quantity: number;
+        }, {
+            processedBy: string;
+            version: number;
+        }>;
+    }> & /*elided*/ any;
+    run(): Promise<void>;
+};
+/**
+ * Mock extra parameter for resource callback
+ */
+export declare function createMockExtra(host: string): {
+    requestInfo: {
+        headers: {
+            host: string;
+        };
+    };
+};
+/**
+ * Sets up environment variables for testing
+ */
+export declare function setTestEnv(env: Record<string, string>): void;
+/**
+ * Resets environment variables
+ */
+export declare function resetTestEnv(): void;

package/dist/{src/test → test}/utils.js

@@ -1,6 +1,6 @@
 import { vi } from "vitest";
+import * as z from "zod";
 import { McpServer } from "../server/server.js";
-import { z } from "zod";
 /**
  * Creates a real McpServer instance for testing
  */
@@ -11,17 +11,17 @@ export function createMockMcpServer() {
         version: "0.0.1",
     }, { capabilities: {} });
     // Mock the underlying methods to track calls
-    const mockResource = vi.spyOn(server, "resource");
+    const mockRegisterResource = vi.spyOn(server, "registerResource");
     const mockRegisterTool = vi.spyOn(server, "registerTool");
     return {
         server,
-        mockResource,
+        mockRegisterResource,
         mockRegisterTool,
     };
 }
 export function createTestServer() {
     return new McpServer({ name: "test-app", version: "1.0.0" }, {})
-        .widget("search-voyage", {}, {
+        .registerWidget("search-voyage", {}, {
         description: "Search for voyages",
         inputSchema: {
             destination: z.string(),
@@ -45,7 +45,7 @@ export function createTestServer() {
             },
         };
     })
-        .widget("get-trip-details", {}, {
+        .registerWidget("get-trip-details", {}, {
         description: "Get trip details",
         inputSchema: {
             tripId: z.string(),
@@ -65,7 +65,7 @@ export function createTestServer() {
             },
         };
     })
-        .widget("no-input-widget", {}, {
+        .registerWidget("no-input-widget", {}, {
         description: "Widget with no input",
         inputSchema: {},
         outputSchema: {},
@@ -75,7 +75,7 @@ export function createTestServer() {
             structuredContent: {},
         };
     })
-        .widget("inferred-output-widget", {}, {
+        .registerWidget("inferred-output-widget", {}, {
         description: "Widget with output inferred from callback",
         inputSchema: {
             query: z.string(),
@@ -121,10 +121,68 @@ export function createTestServer() {
                 fetchedAt: "2024-01-01",
             },
         };
+    })
+        .registerWidget("widget-with-metadata", {}, {
+        description: "Widget that returns response metadata",
+        inputSchema: {
+            resourceId: z.string(),
+        },
+    }, async ({ resourceId }) => {
+        return {
+            content: [{ type: "text", text: `Resource: ${resourceId}` }],
+            structuredContent: {
+                data: { id: resourceId, loaded: true },
+            },
+            _meta: {
+                requestId: "req-123",
+                timestamp: 1704067200000,
+                cached: false,
+            },
+        };
+    })
+        .registerTool("tool-with-metadata", {
+        description: "Tool that returns response metadata",
+        inputSchema: {
+            query: z.string(),
+        },
+    }, async ({ query }) => {
+        return {
+            content: [{ type: "text", text: `Query: ${query}` }],
+            structuredContent: {
+                results: [query],
+            },
+            _meta: {
+                executionTime: 150,
+                source: "cache",
+            },
+        };
+    })
+        .registerWidget("widget-with-mixed-returns", {}, {
+        description: "Widget with mixed return paths (some with _meta, some without)",
+        inputSchema: {
+            shouldSucceed: z.boolean(),
+        },
+    }, async ({ shouldSucceed }) => {
+        if (!shouldSucceed) {
+            // Error path - no _meta
+            return {
+                content: [{ type: "text", text: "Error occurred" }],
+                structuredContent: { error: "Something went wrong" },
+            };
+        }
+        // Success path - has _meta
+        return {
+            content: [{ type: "text", text: "Success" }],
+            structuredContent: { data: "result" },
+            _meta: {
+                processedAt: 1704067200000,
+                region: "eu-west-1",
+            },
+        };
     });
 }
 export function createMinimalTestServer() {
-    return new McpServer({ name: "test-app", version: "1.0.0" }, {}).widget("search-voyage", {}, {
+    return new McpServer({ name: "test-app", version: "1.0.0" }, {}).registerWidget("search-voyage", {}, {
         description: "Search for voyages",
         inputSchema: {
             destination: z.string(),
@@ -139,6 +197,26 @@ export function createMinimalTestServer() {
         };
     });
 }
+export function createInterfaceTestServer() {
+    return new McpServer({ name: "interface-test-app", version: "1.0.0" }, {}).registerWidget("interface-widget", {}, {
+        description: "Widget with interface-typed output",
+        inputSchema: {
+            id: z.string(),
+        },
+    }, async ({ id }) => {
+        return {
+            content: [{ type: "text", text: `Item ${id}` }],
+            structuredContent: {
+                itemName: "Test Item",
+                quantity: 42,
+            },
+            _meta: {
+                processedBy: "test",
+                version: 1,
+            },
+        };
+    });
+}
 /**
  * Mock extra parameter for resource callback
  */