skybridge 0.0.0-dev.e41a369 → 0.0.0-dev.e434f62

package/dist/server/view-resource-resolution.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-resource-resolution.test.js","sourceRoot":"","sources":["../../src/server/view-resource-resolution.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { InMemoryTransport } from \"@modelcontextprotocol/sdk/inMemory.js\";\nimport { afterEach, describe, expect, it } from \"vitest\";\nimport { McpServer } from \"./index.js\";\n\n// Mirror what the Skybridge Vite plugin generates in `.skybridge/views.d.ts`:\n// narrow `ViewName` so `component: \"widget\"` typechecks against the registry.\ndeclare module \"./server.js\" {\n  interface ViewNameRegistry {\n    widget: true;\n  }\n}\n\n// - a view resource must resolve no matter the `?v=` query param value.\n// The version param is a content-derived cache key for external consumers\n// (it busts host/CDN caches when the bundle changes); it is not part of the\n// resource's identity, so a stale, absent, or arbitrary param must still serve\n// the underlying asset.\n\nasync function connect(register: (server: McpServer) => void) {\n  const server = new McpServer({ name: \"test\", version: \"1.0.0\" });\n  register(server);\n  const client = new Client({ name: \"test-client\", version: \"1.0.0\" });\n  const [clientTransport, serverTransport] =\n    InMemoryTransport.createLinkedPair();\n  await server.connect(serverTransport);\n  await client.connect(clientTransport);\n  return {\n    client,\n    teardown: async () => {\n      await client.close();\n      await server.close();\n    },\n  };\n}\n\nfunction registerWidget(server: McpServer) {\n  server.registerTool(\n    { name: \"show\", description: \"show\", view: { component: \"widget\" } },\n    () => ({ content: [{ type: \"text\" as const, text: \"ok\" }] }),\n  );\n}\n\n/** Narrow a read-resource content entry to its text variant. */\nfunction textContent(contents: Array<{ uri: string }>): {\n  uri: string;\n  text: string;\n} {\n  return contents[0] as { uri: string; text: string };\n}\n\ndescribe(\"view resource resolution (cache key)\", () => {\n  afterEach(() => {\n    delete process.env.NODE_ENV;\n  });\n\n  it(\"resolves regardless of the ?v= param and echoes the requested URI\", async () => {\n    const { client, teardown } = await connect(registerWidget);\n\n    const { resources } = await client.listResources();\n    const listed = resources.find((r) =>\n      r.uri.startsWith(\"ui://views/apps-sdk/widget.html\"),\n    );\n    // Dev build advertises no cache key.\n    expect(listed?.uri).toBe(\"ui://views/apps-sdk/widget.html\");\n\n    // A stale/arbitrary/absent param all resolve the same underlying asset,\n    // and the response echoes the URI the consumer asked for (never rewritten).\n    for (const uri of [\n      \"ui://views/apps-sdk/widget.html?v=stale123\",\n      \"ui://views/apps-sdk/widget.html?v=whatever-else\",\n      \"ui://views/apps-sdk/widget.html\",\n    ]) {\n      const { contents } = await client.readResource({ uri });\n      expect(contents).toHaveLength(1);\n      const content = textContent(contents);\n      expect(typeof content.text).toBe(\"string\");\n      expect(content.text.length).toBeGreaterThan(0);\n      expect(content.uri).toBe(uri);\n    }\n\n    await teardown();\n  });\n\n  it(\"resolves a stale cache key when the canonical URI carries ?v= (prod)\", async () => {\n    process.env.NODE_ENV = \"production\";\n\n    const { client, teardown } = await connect((server) => {\n      server.setViteManifest({\n        \"src/views/widget.tsx\": {\n          isEntry: true,\n          name: \"widget\",\n          file: \"assets/widget-ABC123.js\",\n        },\n        \"style.css\": { file: \"assets/style-XYZ.css\" },\n      } as unknown as Record<string, { file: string }>);\n      registerWidget(server);\n    });\n\n    const { resources } = await client.listResources();\n    const listed = resources.find((r) =>\n      r.uri.startsWith(\"ui://views/apps-sdk/widget.html\"),\n    );\n    // Production advertises a content-derived cache key.\n    expect(listed?.uri).toMatch(\n      /^ui:\\/\\/views\\/apps-sdk\\/widget\\.html\\?v=[0-9a-f]{8}$/,\n    );\n\n    // A consumer holding a stale key still resolves the current asset.\n    const staleUri = \"ui://views/apps-sdk/widget.html?v=00000000\";\n    const { contents } = await client.readResource({ uri: staleUri });\n    expect(contents).toHaveLength(1);\n    const content = textContent(contents);\n    expect(typeof content.text).toBe(\"string\");\n    expect(content.uri).toBe(staleUri);\n\n    await teardown();\n  });\n\n  it(\"still throws for an unknown view path\", async () => {\n    const { client, teardown } = await connect(registerWidget);\n\n    await expect(\n      client.readResource({ uri: \"ui://views/apps-sdk/nope.html?v=1\" }),\n    ).rejects.toThrow();\n\n    await teardown();\n  });\n});\n"]}

package/dist/server/viewsDevServer.d.ts

@@ -0,0 +1,14 @@
+import type http from "node:http";
+import { type Router } from "express";
+/**
+ * Vite dev-server middleware for view assets.
+ *
+ * MUST be mounted at the Express app root so Vite can intercept
+ * `/@vite/client`, `/@react-refresh`, and `/_skybridge/view/...` imports:
+ *
+ *   const app = express();
+ *   if (env.NODE_ENV !== "production") {
+ *     app.use(await viewsDevServer(httpServer));
+ *   }
+ */
+export declare const viewsDevServer: (httpServer: http.Server) => Promise<Router>;

package/dist/server/viewsDevServer.js

@@ -0,0 +1,45 @@
+import path from "node:path";
+import cors from "cors";
+import express, {} from "express";
+import { assetBaseUrlTransformPlugin } from "./asset-base-url-transform-plugin.js";
+/**
+ * Vite dev-server middleware for view assets.
+ *
+ * MUST be mounted at the Express app root so Vite can intercept
+ * `/@vite/client`, `/@react-refresh`, and `/_skybridge/view/...` imports:
+ *
+ *   const app = express();
+ *   if (env.NODE_ENV !== "production") {
+ *     app.use(await viewsDevServer(httpServer));
+ *   }
+ */
+export const viewsDevServer = async (httpServer) => {
+    const router = express.Router();
+    const { createServer, loadConfigFromFile } = await import("vite");
+    const root = process.cwd();
+    const configFile = path.join(root, "vite.config.ts");
+    const configResult = await loadConfigFromFile({ command: "serve", mode: "development" }, configFile, root);
+    const { build, preview, plugins: userPlugins = [], ...devConfig } = configResult?.config || {};
+    const vite = await createServer({
+        ...devConfig,
+        // Pass `false` so Vite skips re-resolving a config file — we already
+        // loaded and spread the user's config above.
+        configFile: false,
+        appType: "custom",
+        server: {
+            allowedHosts: true,
+            middlewareMode: true,
+            hmr: {
+                server: httpServer,
+            },
+        },
+        root,
+        // optimizeDeps is set by the skybridge Vite plugin (entries + include)
+        // so it can derive the view glob from `viewsDir`.
+        plugins: [...userPlugins, assetBaseUrlTransformPlugin()],
+    });
+    router.use(cors());
+    router.use("/", vite.middlewares);
+    return router;
+};
+//# sourceMappingURL=viewsDevServer.js.map

package/dist/server/viewsDevServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewsDevServer.js","sourceRoot":"","sources":["../../src/server/viewsDevServer.ts"],"names":[],"mappings":"AACA,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;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,UAAuB,EACN,EAAE;IACnB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAEhC,MAAM,EAAE,YAAY,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAElE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAErD,MAAM,YAAY,GAAG,MAAM,kBAAkB,CAC3C,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,EACzC,UAAU,EACV,IAAI,CACL,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,qEAAqE;QACrE,6CAA6C;QAC7C,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE;YACN,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,IAAI;YACpB,GAAG,EAAE;gBACH,MAAM,EAAE,UAAU;aACnB;SACF;QACD,IAAI;QACJ,uEAAuE;QACvE,kDAAkD;QAClD,OAAO,EAAE,CAAC,GAAG,WAAW,EAAE,2BAA2B,EAAE,CAAC;KACzD,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","sourcesContent":["import type http from \"node:http\";\nimport path from \"node:path\";\nimport cors from \"cors\";\nimport express, { type Router } from \"express\";\nimport { assetBaseUrlTransformPlugin } from \"./asset-base-url-transform-plugin.js\";\n\n/**\n * Vite dev-server middleware for view assets.\n *\n * MUST be mounted at the Express app root so Vite can intercept\n * `/@vite/client`, `/@react-refresh`, and `/_skybridge/view/...` imports:\n *\n *   const app = express();\n *   if (env.NODE_ENV !== \"production\") {\n *     app.use(await viewsDevServer(httpServer));\n *   }\n */\nexport const viewsDevServer = async (\n  httpServer: http.Server,\n): Promise<Router> => {\n  const router = express.Router();\n\n  const { createServer, loadConfigFromFile } = await import(\"vite\");\n\n  const root = process.cwd();\n  const configFile = path.join(root, \"vite.config.ts\");\n\n  const configResult = await loadConfigFromFile(\n    { command: \"serve\", mode: \"development\" },\n    configFile,\n    root,\n  );\n\n  const {\n    build,\n    preview,\n    plugins: userPlugins = [],\n    ...devConfig\n  } = configResult?.config || {};\n\n  const vite = await createServer({\n    ...devConfig,\n    // Pass `false` so Vite skips re-resolving a config file — we already\n    // loaded and spread the user's config above.\n    configFile: false,\n    appType: \"custom\",\n    server: {\n      allowedHosts: true,\n      middlewareMode: true,\n      hmr: {\n        server: httpServer,\n      },\n    },\n    root,\n    // optimizeDeps is set by the skybridge Vite plugin (entries + include)\n    // so it can derive the view glob from `viewsDir`.\n    plugins: [...userPlugins, assetBaseUrlTransformPlugin()],\n  });\n\n  router.use(cors());\n  router.use(\"/\", vite.middlewares);\n\n  return router;\n};\n"]}

package/dist/{src/test → test}/utils.d.ts

@@ -1,15 +1,12 @@
 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"]>;
+    mockRegisterTool: MockInstance;
 };
-export declare function createTestServer(): McpServer<{
-    "search-voyage": import("../server/server.js").ToolDef<{
+export declare function createTestServer(): McpServer<Record<never, import("../server/server.js").ToolDef<unknown, unknown, unknown>> & {
+    "search-trip": import("../server/server.js").ToolDef<{
         destination: string;
         departureDate?: string | undefined;
         maxPrice?: number | undefined;
@@ -30,9 +27,9 @@ export declare function createTestServer(): McpServer<{
         images: string[];
     }, unknown>;
 } & {
-    "no-input-widget": import("../server/server.js").ToolDef<{}, {}, unknown>;
+    "no-input-view": import("../server/server.js").ToolDef<{}, {}, unknown>;
 } & {
-    "inferred-output-widget": import("../server/server.js").ToolDef<{
+    "inferred-output-view": import("../server/server.js").ToolDef<{
         query: string;
     }, {
         inferredResults: {
@@ -60,7 +57,7 @@ export declare function createTestServer(): McpServer<{
         fetchedAt: string;
     }, unknown>;
 } & {
-    "widget-with-metadata": import("../server/server.js").ToolDef<{
+    "view-with-metadata": import("../server/server.js").ToolDef<{
         resourceId: string;
     }, {
         data: {
@@ -82,7 +79,7 @@ export declare function createTestServer(): McpServer<{
         source: string;
     }>;
 } & {
-    "widget-with-mixed-returns": import("../server/server.js").ToolDef<{
+    "view-with-mixed-returns": import("../server/server.js").ToolDef<{
         shouldSucceed: boolean;
     }, {
         error: string;
@@ -95,8 +92,8 @@ export declare function createTestServer(): McpServer<{
         region: string;
     }>;
 }>;
-export declare function createMinimalTestServer(): McpServer<{
-    "search-voyage": import("../server/server.js").ToolDef<{
+export declare function createMinimalTestServer(): McpServer<Record<never, import("../server/server.js").ToolDef<unknown, unknown, unknown>> & {
+    "search-trip": import("../server/server.js").ToolDef<{
         destination: string;
     }, {
         results: {
@@ -104,21 +101,27 @@ export declare function createMinimalTestServer(): McpServer<{
         }[];
     }, unknown>;
 }>;
-/**
- * Mock extra parameter for resource callback
- */
-export declare function createMockExtra(host: string): {
+export declare function createInterfaceTestServer(): McpServer<Record<never, import("../server/server.js").ToolDef<unknown, unknown, unknown>> & {
+    "interface-view": import("../server/server.js").ToolDef<{
+        id: string;
+    }, {
+        itemName: string;
+        quantity: number;
+    }, {
+        processedBy: string;
+        version: number;
+    }>;
+}>;
+export declare function createMockExtra(host: string, options?: {
+    headers?: Record<string, string | string[]>;
+    url?: URL | string;
+}): {
     requestInfo: {
+        url?: string | URL | undefined;
         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,18 +1,14 @@
+import { McpServer as McpServerBase } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { vi } from "vitest";
 import * as z from "zod";
 import { McpServer } from "../server/server.js";
-/**
- * Creates a real McpServer instance for testing
- */
 export function createMockMcpServer() {
-    // Create a real McpServer instance
     const server = new McpServer({
         name: "alpic-openai-app",
         version: "0.0.1",
     }, { capabilities: {} });
-    // Mock the underlying methods to track calls
     const mockRegisterResource = vi.spyOn(server, "registerResource");
-    const mockRegisterTool = vi.spyOn(server, "registerTool");
+    const mockRegisterTool = vi.spyOn(McpServerBase.prototype, "registerTool");
     return {
         server,
         mockRegisterResource,
@@ -21,8 +17,9 @@ export function createMockMcpServer() {
 }
 export function createTestServer() {
     return new McpServer({ name: "test-app", version: "1.0.0" }, {})
-        .registerWidget("search-voyage", {}, {
-        description: "Search for voyages",
+        .registerTool({
+        name: "search-trip",
+        description: "Search for trips",
         inputSchema: {
             destination: z.string(),
             departureDate: z.string().optional(),
@@ -36,6 +33,7 @@ export function createTestServer() {
             })),
             totalCount: z.number(),
         },
+        view: { component: "search-trip" },
     }, async ({ destination }) => {
         return {
             content: [{ type: "text", text: `Found trips to ${destination}` }],
@@ -45,7 +43,8 @@ export function createTestServer() {
             },
         };
     })
-        .registerWidget("get-trip-details", {}, {
+        .registerTool({
+        name: "get-trip-details",
         description: "Get trip details",
         inputSchema: {
             tripId: z.string(),
@@ -55,6 +54,7 @@ export function createTestServer() {
             description: z.string(),
             images: z.array(z.string()),
         },
+        view: { component: "get-trip-details" },
     }, async ({ tripId }) => {
         return {
             content: [{ type: "text", text: `Details for ${tripId}` }],
@@ -65,21 +65,25 @@ export function createTestServer() {
             },
         };
     })
-        .registerWidget("no-input-widget", {}, {
-        description: "Widget with no input",
+        .registerTool({
+        name: "no-input-view",
+        description: "View with no input",
         inputSchema: {},
         outputSchema: {},
+        view: { component: "no-input-view" },
     }, async () => {
         return {
             content: [{ type: "text", text: "No input needed" }],
             structuredContent: {},
         };
     })
-        .registerWidget("inferred-output-widget", {}, {
-        description: "Widget with output inferred from callback",
+        .registerTool({
+        name: "inferred-output-view",
+        description: "View with output inferred from callback",
         inputSchema: {
             query: z.string(),
         },
+        view: { component: "inferred-output-view" },
     }, async ({ query }) => {
         return {
             content: [{ type: "text", text: `Query: ${query}` }],
@@ -89,7 +93,8 @@ export function createTestServer() {
             },
         };
     })
-        .registerTool("calculate-price", {
+        .registerTool({
+        name: "calculate-price",
         description: "Calculate trip price",
         inputSchema: {
             tripId: z.string(),
@@ -108,7 +113,8 @@ export function createTestServer() {
             },
         };
     })
-        .registerTool("inferred-tool", {
+        .registerTool({
+        name: "inferred-tool",
         description: "Tool with output inferred from callback",
         inputSchema: {
             itemId: z.string(),
@@ -122,11 +128,13 @@ export function createTestServer() {
             },
         };
     })
-        .registerWidget("widget-with-metadata", {}, {
-        description: "Widget that returns response metadata",
+        .registerTool({
+        name: "view-with-metadata",
+        description: "View that returns response metadata",
         inputSchema: {
             resourceId: z.string(),
         },
+        view: { component: "view-with-metadata" },
     }, async ({ resourceId }) => {
         return {
             content: [{ type: "text", text: `Resource: ${resourceId}` }],
@@ -140,7 +148,8 @@ export function createTestServer() {
             },
         };
     })
-        .registerTool("tool-with-metadata", {
+        .registerTool({
+        name: "tool-with-metadata",
         description: "Tool that returns response metadata",
         inputSchema: {
             query: z.string(),
@@ -157,20 +166,20 @@ export function createTestServer() {
             },
         };
     })
-        .registerWidget("widget-with-mixed-returns", {}, {
-        description: "Widget with mixed return paths (some with _meta, some without)",
+        .registerTool({
+        name: "view-with-mixed-returns",
+        description: "View with mixed return paths (some with _meta, some without)",
         inputSchema: {
             shouldSucceed: z.boolean(),
         },
+        view: { component: "view-with-mixed-returns" },
     }, 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" },
@@ -182,14 +191,16 @@ export function createTestServer() {
     });
 }
 export function createMinimalTestServer() {
-    return new McpServer({ name: "test-app", version: "1.0.0" }, {}).registerWidget("search-voyage", {}, {
-        description: "Search for voyages",
+    return new McpServer({ name: "test-app", version: "1.0.0" }, {}).registerTool({
+        name: "search-trip",
+        description: "Search for trips",
         inputSchema: {
             destination: z.string(),
         },
         outputSchema: {
             results: z.array(z.object({ id: z.string() })),
         },
+        view: { component: "search-trip" },
     }, async ({ destination }) => {
         return {
             content: [{ type: "text", text: `Found trips to ${destination}` }],
@@ -197,25 +208,39 @@ export function createMinimalTestServer() {
         };
     });
 }
-/**
- * Mock extra parameter for resource callback
- */
-export function createMockExtra(host) {
+export function createInterfaceTestServer() {
+    return new McpServer({ name: "interface-test-app", version: "1.0.0" }, {}).registerTool({
+        name: "interface-view",
+        description: "View with interface-typed output",
+        inputSchema: {
+            id: z.string(),
+        },
+        view: { component: "interface-view" },
+    }, async ({ id }) => {
+        return {
+            content: [{ type: "text", text: `Item ${id}` }],
+            structuredContent: {
+                itemName: "Test Item",
+                quantity: 42,
+            },
+            _meta: {
+                processedBy: "test",
+                version: 1,
+            },
+        };
+    });
+}
+export function createMockExtra(host, options) {
     return {
         requestInfo: {
-            headers: { host },
+            headers: { host, ...(options?.headers ?? {}) },
+            ...(options?.url ? { url: options.url } : {}),
         },
     };
 }
-/**
- * Sets up environment variables for testing
- */
 export function setTestEnv(env) {
     Object.assign(process.env, env);
 }
-/**
- * Resets environment variables
- */
 export function resetTestEnv() {
     delete process.env.NODE_ENV;
 }

package/dist/test/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/test/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { McpServer as McpServerBase } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { type MockInstance, vi } from \"vitest\";\nimport * as z from \"zod\";\nimport { McpServer, type ViewName } from \"../server/server.js\";\n\nexport function createMockMcpServer(): {\n  server: McpServer;\n  mockRegisterResource: MockInstance<McpServer[\"registerResource\"]>;\n  mockRegisterTool: MockInstance;\n} {\n  const server = new McpServer(\n    {\n      name: \"alpic-openai-app\",\n      version: \"0.0.1\",\n    },\n    { capabilities: {} },\n  );\n\n  const mockRegisterResource = vi.spyOn(server, \"registerResource\");\n  const mockRegisterTool = vi.spyOn(McpServerBase.prototype, \"registerTool\");\n\n  return {\n    server,\n    mockRegisterResource,\n    mockRegisterTool,\n  };\n}\n\nexport function createTestServer() {\n  return new McpServer({ name: \"test-app\", version: \"1.0.0\" }, {})\n    .registerTool(\n      {\n        name: \"search-trip\",\n        description: \"Search for trips\",\n        inputSchema: {\n          destination: z.string(),\n          departureDate: z.string().optional(),\n          maxPrice: z.number().optional(),\n        },\n        outputSchema: {\n          results: z.array(\n            z.object({\n              id: z.string(),\n              name: z.string(),\n              price: z.number(),\n            }),\n          ),\n          totalCount: z.number(),\n        },\n        view: { component: \"search-trip\" as ViewName },\n      },\n      async ({ destination }) => {\n        return {\n          content: [{ type: \"text\", text: `Found trips to ${destination}` }],\n          structuredContent: {\n            results: [{ id: \"1\", name: \"Trip\", price: 1000 }],\n            totalCount: 1,\n          },\n        };\n      },\n    )\n    .registerTool(\n      {\n        name: \"get-trip-details\",\n        description: \"Get trip details\",\n        inputSchema: {\n          tripId: z.string(),\n        },\n        outputSchema: {\n          name: z.string(),\n          description: z.string(),\n          images: z.array(z.string()),\n        },\n        view: { component: \"get-trip-details\" as ViewName },\n      },\n      async ({ tripId }) => {\n        return {\n          content: [{ type: \"text\", text: `Details for ${tripId}` }],\n          structuredContent: {\n            name: \"Trip\",\n            description: \"A great trip\",\n            images: [\"image1.jpg\"],\n          },\n        };\n      },\n    )\n    .registerTool(\n      {\n        name: \"no-input-view\",\n        description: \"View with no input\",\n        inputSchema: {},\n        outputSchema: {},\n        view: { component: \"no-input-view\" as ViewName },\n      },\n      async () => {\n        return {\n          content: [{ type: \"text\", text: \"No input needed\" }],\n          structuredContent: {},\n        };\n      },\n    )\n    .registerTool(\n      {\n        name: \"inferred-output-view\",\n        description: \"View with output inferred from callback\",\n        inputSchema: {\n          query: z.string(),\n        },\n        view: { component: \"inferred-output-view\" as ViewName },\n      },\n      async ({ query }) => {\n        return {\n          content: [{ type: \"text\", text: `Query: ${query}` }],\n          structuredContent: {\n            inferredResults: [{ id: \"inferred-1\", score: 0.95 }],\n            inferredCount: 1,\n          },\n        };\n      },\n    )\n    .registerTool(\n      {\n        name: \"calculate-price\",\n        description: \"Calculate trip price\",\n        inputSchema: {\n          tripId: z.string(),\n          passengers: z.number(),\n        },\n        outputSchema: {\n          totalPrice: z.number(),\n          currency: z.string(),\n        },\n      },\n      async ({ tripId, passengers }) => {\n        return {\n          content: [{ type: \"text\", text: `Price for ${tripId}` }],\n          structuredContent: {\n            totalPrice: 1000 * passengers,\n            currency: \"USD\",\n          },\n        };\n      },\n    )\n    .registerTool(\n      {\n        name: \"inferred-tool\",\n        description: \"Tool with output inferred from callback\",\n        inputSchema: {\n          itemId: z.string(),\n        },\n      },\n      async ({ itemId }) => {\n        return {\n          content: [{ type: \"text\", text: `Item: ${itemId}` }],\n          structuredContent: {\n            itemDetails: { name: \"Inferred Item\", available: true },\n            fetchedAt: \"2024-01-01\",\n          },\n        };\n      },\n    )\n    .registerTool(\n      {\n        name: \"view-with-metadata\",\n        description: \"View that returns response metadata\",\n        inputSchema: {\n          resourceId: z.string(),\n        },\n        view: { component: \"view-with-metadata\" as ViewName },\n      },\n      async ({ resourceId }) => {\n        return {\n          content: [{ type: \"text\", text: `Resource: ${resourceId}` }],\n          structuredContent: {\n            data: { id: resourceId, loaded: true },\n          },\n          _meta: {\n            requestId: \"req-123\",\n            timestamp: 1704067200000,\n            cached: false,\n          },\n        };\n      },\n    )\n    .registerTool(\n      {\n        name: \"tool-with-metadata\",\n        description: \"Tool that returns response metadata\",\n        inputSchema: {\n          query: z.string(),\n        },\n      },\n      async ({ query }) => {\n        return {\n          content: [{ type: \"text\", text: `Query: ${query}` }],\n          structuredContent: {\n            results: [query],\n          },\n          _meta: {\n            executionTime: 150,\n            source: \"cache\",\n          },\n        };\n      },\n    )\n    .registerTool(\n      {\n        name: \"view-with-mixed-returns\",\n        description:\n          \"View with mixed return paths (some with _meta, some without)\",\n        inputSchema: {\n          shouldSucceed: z.boolean(),\n        },\n        view: { component: \"view-with-mixed-returns\" as ViewName },\n      },\n      async ({ shouldSucceed }) => {\n        if (!shouldSucceed) {\n          return {\n            content: [{ type: \"text\", text: \"Error occurred\" }],\n            structuredContent: { error: \"Something went wrong\" },\n          };\n        }\n        return {\n          content: [{ type: \"text\", text: \"Success\" }],\n          structuredContent: { data: \"result\" },\n          _meta: {\n            processedAt: 1704067200000,\n            region: \"eu-west-1\",\n          },\n        };\n      },\n    );\n}\n\nexport function createMinimalTestServer() {\n  return new McpServer({ name: \"test-app\", version: \"1.0.0\" }, {}).registerTool(\n    {\n      name: \"search-trip\",\n      description: \"Search for trips\",\n      inputSchema: {\n        destination: z.string(),\n      },\n      outputSchema: {\n        results: z.array(z.object({ id: z.string() })),\n      },\n      view: { component: \"search-trip\" as ViewName },\n    },\n    async ({ destination }) => {\n      return {\n        content: [{ type: \"text\", text: `Found trips to ${destination}` }],\n        structuredContent: { results: [{ id: \"1\" }] },\n      };\n    },\n  );\n}\n\ninterface InterfaceOutput {\n  itemName: string;\n  quantity: number;\n}\n\ninterface InterfaceMeta {\n  processedBy: string;\n  version: number;\n}\n\ninterface InterfaceReturnType {\n  content: [{ type: \"text\"; text: string }];\n  structuredContent: InterfaceOutput;\n  _meta: InterfaceMeta;\n}\n\nexport function createInterfaceTestServer() {\n  return new McpServer(\n    { name: \"interface-test-app\", version: \"1.0.0\" },\n    {},\n  ).registerTool(\n    {\n      name: \"interface-view\" as const,\n      description: \"View with interface-typed output\",\n      inputSchema: {\n        id: z.string(),\n      },\n      view: { component: \"interface-view\" as ViewName },\n    },\n    async ({ id }): Promise<InterfaceReturnType> => {\n      return {\n        content: [{ type: \"text\", text: `Item ${id}` }],\n        structuredContent: {\n          itemName: \"Test Item\",\n          quantity: 42,\n        },\n        _meta: {\n          processedBy: \"test\",\n          version: 1,\n        },\n      };\n    },\n  );\n}\n\nexport function createMockExtra(\n  host: string,\n  options?: {\n    headers?: Record<string, string | string[]>;\n    url?: URL | string;\n  },\n) {\n  return {\n    requestInfo: {\n      headers: { host, ...(options?.headers ?? {}) },\n      ...(options?.url ? { url: options.url } : {}),\n    },\n  };\n}\n\nexport function setTestEnv(env: Record<string, string>) {\n  Object.assign(process.env, env);\n}\n\nexport function resetTestEnv() {\n  delete process.env.NODE_ENV;\n}\n"]}