skybridge 0.0.0-dev.ecf87cf → 0.0.0-dev.ed005a8

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 http from \"node:http\";\nimport {\n  Client,\n  InMemoryTransport,\n  StreamableHTTPClientTransport,\n} from \"@modelcontextprotocol/client\";\nimport type { RequestHandler } from \"express\";\nimport { afterEach, describe, expect, it, vi } from \"vitest\";\nimport { __setBuildManifest, type McpServer, Skybridge } from \"./index.js\";\n\nvi.mock(\"@skybridge/devtools\", () => ({\n  devtoolsStaticServer: () =>\n    ((_req: unknown, _res: unknown, next: () => void) =>\n      next()) as RequestHandler,\n}));\nvi.mock(\"./viewsDevServer.js\", () => ({\n  viewsDevServer: (_httpServer: unknown) =>\n    ((_req: unknown, _res: unknown, next: () => void) =>\n      next()) as RequestHandler,\n}));\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// SKY-435: 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\nfunction buildApp(register: (server: McpServer) => void) {\n  return new Skybridge({\n    name: \"test\",\n    version: \"1.0.0\",\n    handler: (server) => {\n      register(server);\n      return server;\n    },\n  });\n}\n\nasync function connect(register: (server: McpServer) => void) {\n  const instance = await buildApp(register).createServerInstance();\n  const client = new Client({ name: \"test-client\", version: \"1.0.0\" });\n  const [clientTransport, serverTransport] =\n    InMemoryTransport.createLinkedPair();\n  await instance.connect(serverTransport);\n  await client.connect(clientTransport);\n  return {\n    client,\n    teardown: async () => {\n      await client.close();\n      await instance.close();\n    },\n  };\n}\n\nlet openHttpServer: http.Server | undefined;\nafterEach(() => openHttpServer?.close());\n\n// Connect over real HTTP so forwarded proxy headers reach the resource handler.\nasync function connectHttp(\n  register: (server: McpServer) => void,\n  headers: Record<string, string>,\n) {\n  const { createApp } = await import(\"./express.js\");\n  const app = buildApp(register);\n  const httpServer = http.createServer();\n  await createApp({ app, httpServer });\n  const listening = http.createServer(app.express);\n  await new Promise<void>((resolve) => listening.listen(0, resolve));\n  openHttpServer = listening;\n  const port = (listening.address() as { port: number }).port;\n\n  const client = new Client({ name: \"test-client\", version: \"1.0.0\" });\n  const transport = new StreamableHTTPClientTransport(\n    new URL(`http://localhost:${port}/mcp`),\n    { requestInit: { headers } },\n  );\n  await client.connect(transport);\n  return {\n    client,\n    teardown: async () => {\n      await client.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/ext-apps/widget.html\"),\n    );\n    // Dev build advertises no cache key.\n    expect(listed?.uri).toBe(\"ui://views/ext-apps/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/ext-apps/widget.html?v=stale123\",\n      \"ui://views/ext-apps/widget.html?v=whatever-else\",\n      \"ui://views/ext-apps/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    __setBuildManifest({\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\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/ext-apps/widget.html\"),\n    );\n    // Production advertises a content-derived cache key.\n    expect(listed?.uri).toMatch(\n      /^ui:\\/\\/views\\/ext-apps\\/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/ext-apps/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/ext-apps/nope.html?v=1\" }),\n    ).rejects.toThrow();\n\n    await teardown();\n  });\n\n  // A proxy routing the request under a path prefix sends x-forwarded-prefix;\n  // the view's asset URLs must carry that prefix (and the forwarded origin) so\n  // they resolve back through the same routing. Per-request, so one process can\n  // serve many hosts/prefixes at once.\n  it(\"prefixes emitted asset URLs with x-forwarded-prefix (prod)\", async () => {\n    process.env.NODE_ENV = \"production\";\n    __setBuildManifest({\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\n    const { client, teardown } = await connectHttp(registerWidget, {\n      \"x-forwarded-host\": \"foo.com\",\n      \"x-forwarded-proto\": \"https\",\n      \"x-forwarded-prefix\": \"/v1/canary\",\n    });\n    try {\n      const { contents } = await client.readResource({\n        uri: \"ui://views/ext-apps/widget.html\",\n      });\n      const { text } = textContent(contents);\n      // Forwarded origin + prefix. (`assets/assets` is the existing layout: the\n      // manifest `file` already carries `assets/` and the template prepends\n      // `/assets/`; build.tsx's `_redirects` collapses it on the asset host.)\n      expect(text).toContain(\n        \"https://foo.com/v1/canary/assets/assets/widget-ABC123.js\",\n      );\n      expect(text).toContain(\n        \"https://foo.com/v1/canary/assets/assets/style-XYZ.css\",\n      );\n      // No unprefixed asset URL leaks through.\n      expect(text).not.toContain(\"foo.com/assets/\");\n    } finally {\n      await teardown();\n    }\n  });\n\n  // Back-compat: older Skybridge advertised the view at `ui://views/apps-sdk/...`\n  // via openai/outputTemplate. We no longer advertise it, but apps published then\n  // have it cached, so the read must still resolve to the ext-apps content.\n  it(\"resolves the legacy apps-sdk URL to the ext-apps content\", async () => {\n    const { client, teardown } = await connect(registerWidget);\n\n    const legacyUri = \"ui://views/apps-sdk/widget.html\";\n    const { contents } = await client.readResource({ uri: legacyUri });\n\n    expect(contents).toHaveLength(1);\n    const content = contents[0] as {\n      uri: string;\n      text: string;\n      mimeType: string;\n    };\n    expect(content.mimeType).toBe(\"text/html;profile=mcp-app\");\n    expect(content.text.length).toBeGreaterThan(0);\n    // The response echoes the requested (legacy) URI, never the canonical one.\n    expect(content.uri).toBe(legacyUri);\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,48 @@
+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 = [], server: userServer, ...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: {
+            // Keep the user's server options (e.g. forwardConsole) but force the
+            // three settings skybridge's Express integration requires.
+            ...userServer,
+            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,MAAM,EAAE,UAAU,EAClB,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,qEAAqE;YACrE,2DAA2D;YAC3D,GAAG,UAAU;YACb,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    server: userServer,\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      // Keep the user's server options (e.g. forwardConsole) but force the\n      // three settings skybridge's Express integration requires.\n      ...userServer,\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,13 @@
 import { type MockInstance } from "vitest";
+import { Skybridge } from "../server/app.js";
 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<Record<never, import("../server/server.js").ToolDef<unknown, unknown, unknown>> & {
-    "search-voyage": import("../server/server.js").ToolDef<{
+export declare function createTestApp(): Skybridge<Record<never, import("../server/server.js").ToolDef> & {
+    "search-trip": import("../server/server.js").ToolDef<{
         destination: string;
         departureDate?: string | undefined;
         maxPrice?: number | undefined;
@@ -30,9 +28,9 @@ export declare function createTestServer(): McpServer<Record<never, import("../s
         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 +58,7 @@ export declare function createTestServer(): McpServer<Record<never, import("../s
         fetchedAt: string;
     }, unknown>;
 } & {
-    "widget-with-metadata": import("../server/server.js").ToolDef<{
+    "view-with-metadata": import("../server/server.js").ToolDef<{
         resourceId: string;
     }, {
         data: {
@@ -82,7 +80,7 @@ export declare function createTestServer(): McpServer<Record<never, import("../s
         source: string;
     }>;
 } & {
-    "widget-with-mixed-returns": import("../server/server.js").ToolDef<{
+    "view-with-mixed-returns": import("../server/server.js").ToolDef<{
         shouldSucceed: boolean;
     }, {
         error: string;
@@ -94,18 +92,18 @@ export declare function createTestServer(): McpServer<Record<never, import("../s
         processedAt: number;
         region: string;
     }>;
-}>;
-export declare function createMinimalTestServer(): McpServer<Record<never, import("../server/server.js").ToolDef<unknown, unknown, unknown>> & {
-    "search-voyage": import("../server/server.js").ToolDef<{
+}, undefined, import("../server/auth.js").ExtraClaims>;
+export declare function createMinimalTestApp(): Skybridge<Record<never, import("../server/server.js").ToolDef> & {
+    "search-trip": import("../server/server.js").ToolDef<{
         destination: string;
     }, {
         results: {
             id: string;
         }[];
     }, unknown>;
-}>;
-export declare function createInterfaceTestServer(): McpServer<Record<never, import("../server/server.js").ToolDef<unknown, unknown, unknown>> & {
-    "interface-widget": import("../server/server.js").ToolDef<{
+}, undefined, import("../server/auth.js").ExtraClaims>;
+export declare function createInterfaceTestApp(): Skybridge<Record<never, import("../server/server.js").ToolDef> & {
+    "interface-view": import("../server/server.js").ToolDef<{
         id: string;
     }, {
         itemName: string;
@@ -114,22 +112,14 @@ export declare function createInterfaceTestServer(): McpServer<Record<never, imp
         processedBy: string;
         version: number;
     }>;
-}>;
-/**
- * Mock extra parameter for resource callback
- */
-export declare function createMockExtra(host: string): {
-    requestInfo: {
-        headers: {
-            host: string;
-        };
+}, undefined, import("../server/auth.js").ExtraClaims>;
+export declare function createMockExtra(host: string, options?: {
+    headers?: Record<string, string | string[]>;
+    url?: URL | string;
+}): {
+    http: {
+        req: Request;
     };
 };
-/**
- * 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/test/utils.js

@@ -0,0 +1,266 @@
+import { McpServer as McpServerBase } from "@modelcontextprotocol/server";
+import { vi } from "vitest";
+import * as z from "zod";
+import { Skybridge } from "../server/app.js";
+import { McpServer } from "../server/server.js";
+export function createMockMcpServer() {
+    const server = new McpServer({
+        name: "alpic-openai-app",
+        version: "0.0.1",
+    });
+    const mockRegisterResource = vi.spyOn(server, "registerResource");
+    const mockRegisterTool = vi.spyOn(McpServerBase.prototype, "registerTool");
+    return {
+        server,
+        mockRegisterResource,
+        mockRegisterTool,
+    };
+}
+export function createTestApp() {
+    return new Skybridge({
+        name: "test-app",
+        version: "1.0.0",
+        handler: (server) => server
+            .registerTool({
+            name: "search-trip",
+            description: "Search for trips",
+            inputSchema: {
+                destination: z.string(),
+                departureDate: z.string().optional(),
+                maxPrice: z.number().optional(),
+            },
+            outputSchema: {
+                results: z.array(z.object({
+                    id: z.string(),
+                    name: z.string(),
+                    price: z.number(),
+                })),
+                totalCount: z.number(),
+            },
+            view: { component: "search-trip" },
+        }, async ({ destination }) => {
+            return {
+                content: [
+                    { type: "text", text: `Found trips to ${destination}` },
+                ],
+                structuredContent: {
+                    results: [{ id: "1", name: "Trip", price: 1000 }],
+                    totalCount: 1,
+                },
+            };
+        })
+            .registerTool({
+            name: "get-trip-details",
+            description: "Get trip details",
+            inputSchema: {
+                tripId: z.string(),
+            },
+            outputSchema: {
+                name: z.string(),
+                description: z.string(),
+                images: z.array(z.string()),
+            },
+            view: { component: "get-trip-details" },
+        }, async ({ tripId }) => {
+            return {
+                content: [{ type: "text", text: `Details for ${tripId}` }],
+                structuredContent: {
+                    name: "Trip",
+                    description: "A great trip",
+                    images: ["image1.jpg"],
+                },
+            };
+        })
+            .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: {},
+            };
+        })
+            .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}` }],
+                structuredContent: {
+                    inferredResults: [{ id: "inferred-1", score: 0.95 }],
+                    inferredCount: 1,
+                },
+            };
+        })
+            .registerTool({
+            name: "calculate-price",
+            description: "Calculate trip price",
+            inputSchema: {
+                tripId: z.string(),
+                passengers: z.number(),
+            },
+            outputSchema: {
+                totalPrice: z.number(),
+                currency: z.string(),
+            },
+        }, async ({ tripId, passengers }) => {
+            return {
+                content: [{ type: "text", text: `Price for ${tripId}` }],
+                structuredContent: {
+                    totalPrice: 1000 * passengers,
+                    currency: "USD",
+                },
+            };
+        })
+            .registerTool({
+            name: "inferred-tool",
+            description: "Tool with output inferred from callback",
+            inputSchema: {
+                itemId: z.string(),
+            },
+        }, async ({ itemId }) => {
+            return {
+                content: [{ type: "text", text: `Item: ${itemId}` }],
+                structuredContent: {
+                    itemDetails: { name: "Inferred Item", available: true },
+                    fetchedAt: "2024-01-01",
+                },
+            };
+        })
+            .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}` }],
+                structuredContent: {
+                    data: { id: resourceId, loaded: true },
+                },
+                _meta: {
+                    requestId: "req-123",
+                    timestamp: 1704067200000,
+                    cached: false,
+                },
+            };
+        })
+            .registerTool({
+            name: "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",
+                },
+            };
+        })
+            .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) {
+                return {
+                    content: [{ type: "text", text: "Error occurred" }],
+                    structuredContent: { error: "Something went wrong" },
+                };
+            }
+            return {
+                content: [{ type: "text", text: "Success" }],
+                structuredContent: { data: "result" },
+                _meta: {
+                    processedAt: 1704067200000,
+                    region: "eu-west-1",
+                },
+            };
+        }),
+    });
+}
+export function createMinimalTestApp() {
+    return new Skybridge({
+        name: "test-app",
+        version: "1.0.0",
+        handler: (server) => server.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}` }],
+                structuredContent: { results: [{ id: "1" }] },
+            };
+        }),
+    });
+}
+export function createInterfaceTestApp() {
+    return new Skybridge({
+        name: "interface-test-app",
+        version: "1.0.0",
+        handler: (server) => server.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) {
+    const headers = new Headers();
+    headers.set("host", host);
+    for (const [key, value] of Object.entries(options?.headers ?? {})) {
+        headers.set(key, Array.isArray(value) ? value.join(", ") : value);
+    }
+    return {
+        http: {
+            req: new Request(String(options?.url ?? `https://${host}`), { headers }),
+        },
+    };
+}
+export function setTestEnv(env) {
+    Object.assign(process.env, env);
+}
+export function resetTestEnv() {
+    delete process.env.NODE_ENV;
+}
+//# sourceMappingURL=utils.js.map

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/server\";\nimport { type MockInstance, vi } from \"vitest\";\nimport * as z from \"zod\";\nimport { Skybridge } from \"../server/app.js\";\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    name: \"alpic-openai-app\",\n    version: \"0.0.1\",\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 createTestApp() {\n  return new Skybridge({\n    name: \"test-app\",\n    version: \"1.0.0\",\n    handler: (server) =>\n      server\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: [\n                { type: \"text\", text: `Found trips to ${destination}` },\n              ],\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}\n\nexport function createMinimalTestApp() {\n  return new Skybridge({\n    name: \"test-app\",\n    version: \"1.0.0\",\n    handler: (server) =>\n      server.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}\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 createInterfaceTestApp() {\n  return new Skybridge({\n    name: \"interface-test-app\",\n    version: \"1.0.0\",\n    handler: (server) =>\n      server.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}\n\nexport function createMockExtra(\n  host: string,\n  options?: {\n    headers?: Record<string, string | string[]>;\n    url?: URL | string;\n  },\n) {\n  const headers = new Headers();\n  headers.set(\"host\", host);\n  for (const [key, value] of Object.entries(options?.headers ?? {})) {\n    headers.set(key, Array.isArray(value) ? value.join(\", \") : value);\n  }\n  return {\n    http: {\n      req: new Request(String(options?.url ?? `https://${host}`), { headers }),\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"]}

package/dist/test/view.test.d.ts

@@ -0,0 +1 @@
+export {};