skybridge 0.0.0-dev.f025fa9 → 0.0.0-dev.f0394fc

package/dist/server/register-tool.test.js

@@ -0,0 +1,230 @@
+import { Client, InMemoryTransport } from "@modelcontextprotocol/client";
+import { describe, expect, it } from "vitest";
+import { z } from "zod";
+import { Skybridge } from "./app.js";
+describe("registerTool handler invocation", () => {
+    it("passes empty args and a usable extra to a schema-less tool handler", async () => {
+        let received;
+        const app = new Skybridge({
+            name: "test",
+            version: "1.0.0",
+            handler: (server) => server.registerTool({ name: "no-input", description: "no-input" }, async (args, extra) => {
+                received = { args, extra };
+                return { content: [{ type: "text", text: "ok" }] };
+            }),
+        });
+        const instance = await app.createServerInstance();
+        const client = new Client({ name: "client", version: "1.0.0" });
+        const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+        await instance.connect(serverTransport);
+        await client.connect(clientTransport);
+        await client.callTool({ name: "no-input" });
+        expect(received?.args).toEqual({});
+        expect(received?.extra).toHaveProperty("mcpReq.send");
+        await client.close();
+        await instance.close();
+    });
+    it("emits openai options as openai/ui metadata on the tool and its view", async () => {
+        const app = new Skybridge({
+            name: "test",
+            version: "1.0.0",
+            handler: (server) => server.registerTool({
+                name: "library",
+                description: "library",
+                view: { component: "widget" },
+                openai: {
+                    entrypoints: [
+                        { type: "global" },
+                        { type: "file", extensions: [".stl"] },
+                    ],
+                    availableDisplayModes: ["inline", "fullscreen"],
+                    preferredDisplayMode: "fullscreen",
+                },
+            }, async () => ({ content: "ok" })),
+        });
+        const instance = await app.createServerInstance();
+        const client = new Client({ name: "client", version: "1.0.0" });
+        const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+        await instance.connect(serverTransport);
+        await client.connect(clientTransport);
+        const { tools } = await client.listTools();
+        const { resources } = await client.listResources();
+        expect(tools[0]?._meta?.["openai/ui"]).toEqual({
+            entrypoints: [{ type: "global" }, { type: "file", extensions: [".stl"] }],
+        });
+        expect(resources[0]?._meta?.["openai/ui"]).toEqual({
+            availableDisplayModes: ["inline", "fullscreen"],
+            preferredDisplayMode: "fullscreen",
+        });
+        await client.close();
+        await instance.close();
+    });
+    it("rejects a global entrypoint on a tool that requires input", async () => {
+        const app = new Skybridge({
+            name: "test",
+            version: "1.0.0",
+            handler: (server) => server.registerTool({
+                name: "search",
+                description: "search",
+                inputSchema: { query: z.string() },
+                view: { component: "widget" },
+                openai: { entrypoints: [{ type: "global" }] },
+            }, async () => ({ content: "ok" })),
+        });
+        await expect(app.createServerInstance()).rejects.toThrow(/rejects `\{\}`/);
+    });
+    it("registers mention search as an app-only tool advertising the extension", async () => {
+        const app = new Skybridge({
+            name: "test",
+            version: "1.0.0",
+            handler: (server) => server.registerMentions({
+                name: "search_parts",
+                handler: async ({ query }) => ({
+                    items: [
+                        { type: "resource_link", uri: `parts://${query}`, name: query },
+                    ],
+                }),
+            }),
+        });
+        const instance = await app.createServerInstance();
+        const client = new Client({ name: "client", version: "1.0.0" });
+        const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+        await instance.connect(serverTransport);
+        await client.connect(clientTransport);
+        const { tools } = await client.listTools();
+        expect(tools[0]?._meta).toMatchObject({
+            "openai/extensions": { "mentions/search": {} },
+            ui: { visibility: ["app"] },
+        });
+        const result = await client.callTool({
+            name: "search_parts",
+            arguments: { query: "bolt" },
+        });
+        expect(result.structuredContent).toEqual({
+            items: [{ type: "resource_link", uri: "parts://bolt", name: "bolt" }],
+        });
+        await client.close();
+        await instance.close();
+    });
+    it("registers settings tools and advertises the settings capability", async () => {
+        let stored = { units: "mm", zoom: 3 };
+        const fields = {
+            units: { title: "Units", schema: z.enum(["mm", "in"]) },
+            zoom: { title: "Zoom", schema: z.number() },
+        };
+        const app = new Skybridge({
+            name: "test",
+            version: "1.0.0",
+            handler: (server) => server.registerSettings({
+                fields,
+                layout: [
+                    {
+                        kind: "group",
+                        title: "Display",
+                        items: [{ kind: "property", property: "units" }],
+                    },
+                ],
+                read: () => stored,
+                update: (set) => {
+                    stored = { ...stored, ...set };
+                    return stored;
+                },
+            }),
+        });
+        const instance = await app.createServerInstance();
+        const client = new Client({ name: "client", version: "1.0.0" });
+        const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+        await instance.connect(serverTransport);
+        await client.connect(clientTransport);
+        const capability = {
+            readTool: "settings.read",
+            updateTool: "settings.update",
+        };
+        expect(client.getServerCapabilities()).toMatchObject({
+            extensions: { "openai/settings": capability },
+            experimental: { "openai/settings": capability },
+        });
+        const { tools } = await client.listTools();
+        expect(tools).toMatchObject([
+            {
+                name: "settings.read",
+                annotations: { readOnlyHint: true },
+                outputSchema: { required: ["schema", "values"] },
+            },
+            {
+                name: "settings.update",
+                inputSchema: {
+                    properties: {
+                        set: { additionalProperties: false, minProperties: 1 },
+                    },
+                },
+            },
+        ]);
+        const read = await client.callTool({
+            name: "settings.read",
+            arguments: {},
+        });
+        expect(read.structuredContent).toMatchObject({
+            schema: {
+                type: "object",
+                properties: {
+                    units: { type: "string", enum: ["mm", "in"], title: "Units" },
+                    zoom: { type: "number", title: "Zoom" },
+                },
+                required: ["units", "zoom"],
+            },
+            values: { units: "mm", zoom: 3 },
+            layout: [{ kind: "group", title: "Display" }],
+        });
+        const updated = await client.callTool({
+            name: "settings.update",
+            arguments: { set: { units: "in" } },
+        });
+        expect(updated.structuredContent).toEqual({
+            values: { units: "in", zoom: 3 },
+        });
+        const empty = await client.callTool({
+            name: "settings.update",
+            arguments: { set: {} },
+        });
+        expect(empty.isError).toBe(true);
+        await client.close();
+        await instance.close();
+        const withDefault = new Skybridge({
+            name: "test",
+            version: "1.0.0",
+            handler: (server) => server.registerSettings({
+                fields: {
+                    grid: { title: "Grid", schema: z.boolean().prefault(true) },
+                },
+                read: () => ({ grid: true }),
+                update: () => ({ grid: true }),
+            }),
+        });
+        await expect(withDefault.createServerInstance()).rejects.toThrow(/declares a default/);
+    });
+    it("registers a file viewer with the file input and a file entrypoint", async () => {
+        const app = new Skybridge({
+            name: "test",
+            version: "1.0.0",
+            handler: (server) => server.registerFileViewer({
+                name: "part-viewer",
+                extensions: [".stl"],
+                view: { component: "widget" },
+            }, async ({ file }) => ({ content: file.name })),
+        });
+        const instance = await app.createServerInstance();
+        const client = new Client({ name: "client", version: "1.0.0" });
+        const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+        await instance.connect(serverTransport);
+        await client.connect(clientTransport);
+        const { tools } = await client.listTools();
+        expect(tools[0]?._meta?.["openai/ui"]).toEqual({
+            entrypoints: [{ type: "file", extensions: [".stl"] }],
+        });
+        expect(tools[0]?.inputSchema.required).toEqual(["file"]);
+        await client.close();
+        await instance.close();
+    });
+});
+//# sourceMappingURL=register-tool.test.js.map

package/dist/server/register-tool.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-tool.test.js","sourceRoot":"","sources":["../../src/server/register-tool.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { Client, InMemoryTransport } from \"@modelcontextprotocol/client\";\nimport { describe, expect, it } from \"vitest\";\nimport { z } from \"zod\";\nimport { Skybridge } from \"./app.js\";\n\ndescribe(\"registerTool handler invocation\", () => {\n  it(\"passes empty args and a usable extra to a schema-less tool handler\", async () => {\n    let received: { args: unknown; extra: unknown } | undefined;\n    const app = new Skybridge({\n      name: \"test\",\n      version: \"1.0.0\",\n      handler: (server) =>\n        server.registerTool(\n          { name: \"no-input\", description: \"no-input\" },\n          async (args, extra) => {\n            received = { args, extra };\n            return { content: [{ type: \"text\", text: \"ok\" }] };\n          },\n        ),\n    });\n    const instance = await app.createServerInstance();\n\n    const client = new Client({ name: \"client\", version: \"1.0.0\" });\n    const [clientTransport, serverTransport] =\n      InMemoryTransport.createLinkedPair();\n    await instance.connect(serverTransport);\n    await client.connect(clientTransport);\n\n    await client.callTool({ name: \"no-input\" });\n\n    expect(received?.args).toEqual({});\n    expect(received?.extra).toHaveProperty(\"mcpReq.send\");\n\n    await client.close();\n    await instance.close();\n  });\n\n  it(\"emits openai options as openai/ui metadata on the tool and its view\", async () => {\n    const app = new Skybridge({\n      name: \"test\",\n      version: \"1.0.0\",\n      handler: (server) =>\n        server.registerTool(\n          {\n            name: \"library\",\n            description: \"library\",\n            view: { component: \"widget\" },\n            openai: {\n              entrypoints: [\n                { type: \"global\" },\n                { type: \"file\", extensions: [\".stl\"] },\n              ],\n              availableDisplayModes: [\"inline\", \"fullscreen\"],\n              preferredDisplayMode: \"fullscreen\",\n            },\n          },\n          async () => ({ content: \"ok\" }),\n        ),\n    });\n    const instance = await app.createServerInstance();\n    const client = new Client({ name: \"client\", version: \"1.0.0\" });\n    const [clientTransport, serverTransport] =\n      InMemoryTransport.createLinkedPair();\n    await instance.connect(serverTransport);\n    await client.connect(clientTransport);\n\n    const { tools } = await client.listTools();\n    const { resources } = await client.listResources();\n\n    expect(tools[0]?._meta?.[\"openai/ui\"]).toEqual({\n      entrypoints: [{ type: \"global\" }, { type: \"file\", extensions: [\".stl\"] }],\n    });\n    expect(resources[0]?._meta?.[\"openai/ui\"]).toEqual({\n      availableDisplayModes: [\"inline\", \"fullscreen\"],\n      preferredDisplayMode: \"fullscreen\",\n    });\n\n    await client.close();\n    await instance.close();\n  });\n\n  it(\"rejects a global entrypoint on a tool that requires input\", async () => {\n    const app = new Skybridge({\n      name: \"test\",\n      version: \"1.0.0\",\n      handler: (server) =>\n        server.registerTool(\n          {\n            name: \"search\",\n            description: \"search\",\n            inputSchema: { query: z.string() },\n            view: { component: \"widget\" },\n            openai: { entrypoints: [{ type: \"global\" }] },\n          },\n          async () => ({ content: \"ok\" }),\n        ),\n    });\n\n    await expect(app.createServerInstance()).rejects.toThrow(/rejects `\\{\\}`/);\n  });\n\n  it(\"registers mention search as an app-only tool advertising the extension\", async () => {\n    const app = new Skybridge({\n      name: \"test\",\n      version: \"1.0.0\",\n      handler: (server) =>\n        server.registerMentions({\n          name: \"search_parts\",\n          handler: async ({ query }) => ({\n            items: [\n              { type: \"resource_link\", uri: `parts://${query}`, name: query },\n            ],\n          }),\n        }),\n    });\n    const instance = await app.createServerInstance();\n    const client = new Client({ name: \"client\", version: \"1.0.0\" });\n    const [clientTransport, serverTransport] =\n      InMemoryTransport.createLinkedPair();\n    await instance.connect(serverTransport);\n    await client.connect(clientTransport);\n\n    const { tools } = await client.listTools();\n    expect(tools[0]?._meta).toMatchObject({\n      \"openai/extensions\": { \"mentions/search\": {} },\n      ui: { visibility: [\"app\"] },\n    });\n    const result = await client.callTool({\n      name: \"search_parts\",\n      arguments: { query: \"bolt\" },\n    });\n    expect(result.structuredContent).toEqual({\n      items: [{ type: \"resource_link\", uri: \"parts://bolt\", name: \"bolt\" }],\n    });\n\n    await client.close();\n    await instance.close();\n  });\n\n  it(\"registers settings tools and advertises the settings capability\", async () => {\n    let stored = { units: \"mm\" as \"mm\" | \"in\", zoom: 3 };\n    const fields = {\n      units: { title: \"Units\", schema: z.enum([\"mm\", \"in\"]) },\n      zoom: { title: \"Zoom\", schema: z.number() },\n    };\n    const app = new Skybridge({\n      name: \"test\",\n      version: \"1.0.0\",\n      handler: (server) =>\n        server.registerSettings({\n          fields,\n          layout: [\n            {\n              kind: \"group\",\n              title: \"Display\",\n              items: [{ kind: \"property\", property: \"units\" }],\n            },\n          ],\n          read: () => stored,\n          update: (set) => {\n            stored = { ...stored, ...set };\n            return stored;\n          },\n        }),\n    });\n    const instance = await app.createServerInstance();\n    const client = new Client({ name: \"client\", version: \"1.0.0\" });\n    const [clientTransport, serverTransport] =\n      InMemoryTransport.createLinkedPair();\n    await instance.connect(serverTransport);\n    await client.connect(clientTransport);\n\n    const capability = {\n      readTool: \"settings.read\",\n      updateTool: \"settings.update\",\n    };\n    expect(client.getServerCapabilities()).toMatchObject({\n      extensions: { \"openai/settings\": capability },\n      experimental: { \"openai/settings\": capability },\n    });\n    const { tools } = await client.listTools();\n    expect(tools).toMatchObject([\n      {\n        name: \"settings.read\",\n        annotations: { readOnlyHint: true },\n        outputSchema: { required: [\"schema\", \"values\"] },\n      },\n      {\n        name: \"settings.update\",\n        inputSchema: {\n          properties: {\n            set: { additionalProperties: false, minProperties: 1 },\n          },\n        },\n      },\n    ]);\n    const read = await client.callTool({\n      name: \"settings.read\",\n      arguments: {},\n    });\n    expect(read.structuredContent).toMatchObject({\n      schema: {\n        type: \"object\",\n        properties: {\n          units: { type: \"string\", enum: [\"mm\", \"in\"], title: \"Units\" },\n          zoom: { type: \"number\", title: \"Zoom\" },\n        },\n        required: [\"units\", \"zoom\"],\n      },\n      values: { units: \"mm\", zoom: 3 },\n      layout: [{ kind: \"group\", title: \"Display\" }],\n    });\n    const updated = await client.callTool({\n      name: \"settings.update\",\n      arguments: { set: { units: \"in\" } },\n    });\n    expect(updated.structuredContent).toEqual({\n      values: { units: \"in\", zoom: 3 },\n    });\n    const empty = await client.callTool({\n      name: \"settings.update\",\n      arguments: { set: {} },\n    });\n    expect(empty.isError).toBe(true);\n\n    await client.close();\n    await instance.close();\n\n    const withDefault = new Skybridge({\n      name: \"test\",\n      version: \"1.0.0\",\n      handler: (server) =>\n        server.registerSettings({\n          fields: {\n            grid: { title: \"Grid\", schema: z.boolean().prefault(true) },\n          },\n          read: () => ({ grid: true }),\n          update: () => ({ grid: true }),\n        }),\n    });\n    await expect(withDefault.createServerInstance()).rejects.toThrow(\n      /declares a default/,\n    );\n  });\n\n  it(\"registers a file viewer with the file input and a file entrypoint\", async () => {\n    const app = new Skybridge({\n      name: \"test\",\n      version: \"1.0.0\",\n      handler: (server) =>\n        server.registerFileViewer(\n          {\n            name: \"part-viewer\",\n            extensions: [\".stl\"],\n            view: { component: \"widget\" },\n          },\n          async ({ file }) => ({ content: file.name }),\n        ),\n    });\n    const instance = await app.createServerInstance();\n    const client = new Client({ name: \"client\", version: \"1.0.0\" });\n    const [clientTransport, serverTransport] =\n      InMemoryTransport.createLinkedPair();\n    await instance.connect(serverTransport);\n    await client.connect(clientTransport);\n\n    const { tools } = await client.listTools();\n    expect(tools[0]?._meta?.[\"openai/ui\"]).toEqual({\n      entrypoints: [{ type: \"file\", extensions: [\".stl\"] }],\n    });\n    expect(tools[0]?.inputSchema.required).toEqual([\"file\"]);\n\n    await client.close();\n    await instance.close();\n  });\n});\n"]}

package/dist/server/requestOrigin.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Resolves this server's public origin from request headers, in precedence
+ * `x-forwarded-host` → `host` → localhost dev fallback. Shared by view serving
+ * and OAuth metadata so the two can't drift. `Origin` is deliberately ignored:
+ * it carries the *caller's* site, not this server's.
+ */
+export declare function resolveServerOrigin(header: (key: string) => string | undefined): string;

package/dist/server/requestOrigin.js

@@ -0,0 +1,25 @@
+/**
+ * Resolves this server's public origin from request headers, in precedence
+ * `x-forwarded-host` → `host` → localhost dev fallback. Shared by view serving
+ * and OAuth metadata so the two can't drift. `Origin` is deliberately ignored:
+ * it carries the *caller's* site, not this server's.
+ */
+export function resolveServerOrigin(header) {
+    // Proxies may send X-Forwarded-* as a comma-separated chain; the client-facing
+    // hop is the first entry.
+    const firstHop = (value) => value?.split(",")[0]?.trim();
+    const forwardedHost = firstHop(header("x-forwarded-host"));
+    if (forwardedHost) {
+        const proto = firstHop(header("x-forwarded-proto")) || "https";
+        return `${proto}://${forwardedHost}`;
+    }
+    const host = header("host");
+    if (host) {
+        const proto = ["127.0.0.1:", "localhost:"].some((p) => host.startsWith(p))
+            ? "http"
+            : "https";
+        return `${proto}://${host}`;
+    }
+    return `http://localhost:${process.env.__PORT || "3000"}`;
+}
+//# sourceMappingURL=requestOrigin.js.map

package/dist/server/requestOrigin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestOrigin.js","sourceRoot":"","sources":["../../src/server/requestOrigin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAA2C;IAE3C,+EAA+E;IAC/E,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,CAAC,KAAyB,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;IAC7E,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC3D,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,IAAI,OAAO,CAAC;QAC/D,OAAO,GAAG,KAAK,MAAM,aAAa,EAAE,CAAC;IACvC,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5B,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,KAAK,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACxE,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,OAAO,CAAC;QACZ,OAAO,GAAG,KAAK,MAAM,IAAI,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,oBAAoB,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;AAC5D,CAAC","sourcesContent":["/**\n * Resolves this server's public origin from request headers, in precedence\n * `x-forwarded-host` → `host` → localhost dev fallback. Shared by view serving\n * and OAuth metadata so the two can't drift. `Origin` is deliberately ignored:\n * it carries the *caller's* site, not this server's.\n */\nexport function resolveServerOrigin(\n  header: (key: string) => string | undefined,\n): string {\n  // Proxies may send X-Forwarded-* as a comma-separated chain; the client-facing\n  // hop is the first entry.\n  const firstHop = (value: string | undefined) => value?.split(\",\")[0]?.trim();\n  const forwardedHost = firstHop(header(\"x-forwarded-host\"));\n  if (forwardedHost) {\n    const proto = firstHop(header(\"x-forwarded-proto\")) || \"https\";\n    return `${proto}://${forwardedHost}`;\n  }\n  const host = header(\"host\");\n  if (host) {\n    const proto = [\"127.0.0.1:\", \"localhost:\"].some((p) => host.startsWith(p))\n      ? \"http\"\n      : \"https\";\n    return `${proto}://${host}`;\n  }\n  return `http://localhost:${process.env.__PORT || \"3000\"}`;\n}\n"]}