@lovable.dev/mcp-js 3.3.1 → 3.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.internal.md +38 -12
- package/README.md +140 -12
- package/dist/THIRD_PARTY_NOTICES +75 -0
- package/dist/apps-CWG3rGhB.js +132 -0
- package/dist/apps-DyoDrwfi.cjs +185 -0
- package/dist/{authorize-CoaAw6wg.d.cts → authorize--W1XtwdB.d.cts} +1 -1
- package/dist/{authorize-BV62MDan.d.ts → authorize-DpNYioXM.d.ts} +1 -1
- package/dist/{base-Cx0spfMk.d.ts → base-Ce9JYirF.d.ts} +1 -1
- package/dist/{base-CzWe8AD1.d.cts → base-qEX8YVcD.d.cts} +1 -1
- package/dist/cli/check-server.cjs +1 -1
- package/dist/cli/check-server.js +1 -1
- package/dist/cli/extract-manifest.cjs +1 -1
- package/dist/cli/extract-manifest.js +1 -1
- package/dist/{cors-3HjrsmEW.cjs → cors-B_Oui5La.cjs} +1 -1
- package/dist/{cors-CNNmKKIg.js → cors-D83r8WUF.js} +1 -1
- package/dist/dist-CIu-UFye.js +6738 -0
- package/dist/dist-CqY2qXpc.cjs +6738 -0
- package/dist/{errors-CIpFAb6i.js → errors-CfaxXr2T.js} +15 -2
- package/dist/{errors-C97I7VOC.cjs → errors-xJ_7Su1K.cjs} +20 -1
- package/dist/index.cjs +2 -1
- package/dist/index.d.cts +6 -2
- package/dist/index.d.ts +6 -2
- package/dist/index.js +2 -2
- package/dist/{io-D7cpdBJO.d.ts → io-BEpyfk4G.d.ts} +1 -1
- package/dist/{io-CaBSlPwS.cjs → io-CUnV4kTL.cjs} +12 -2
- package/dist/{io-DC-Y6R61.d.cts → io-Di5ljvZY.d.cts} +1 -1
- package/dist/{io-CahnhUhA.js → io-STpVLkbi.js} +13 -3
- package/dist/{mcp-DC8AoD18.js → mcp-BgIFUoo1.js} +110 -49
- package/dist/{mcp-DlWLIwX9.cjs → mcp-DpI0wwnW.cjs} +110 -49
- package/dist/mcp-app.d.ts +4 -0
- package/dist/{package-B488glmj.cjs → package-CuCho6-k.cjs} +1 -1
- package/dist/{package-CukfP_vq.js → package-Cz6Z5F_X.js} +1 -1
- package/dist/protocols/mcp/index.cjs +1 -1
- package/dist/protocols/mcp/index.d.cts +3 -3
- package/dist/protocols/mcp/index.d.ts +3 -3
- package/dist/protocols/mcp/index.js +1 -1
- package/dist/protocols/oauth-metadata.cjs +1 -1
- package/dist/protocols/oauth-metadata.d.cts +3 -3
- package/dist/protocols/oauth-metadata.d.ts +3 -3
- package/dist/protocols/oauth-metadata.js +1 -1
- package/dist/src-D7RtXSV0.cjs +311 -0
- package/dist/src-sWQwyLwS.js +310 -0
- package/dist/stacks/supabase/index.cjs +2 -2
- package/dist/stacks/supabase/index.d.cts +1 -1
- package/dist/stacks/supabase/index.d.ts +1 -1
- package/dist/stacks/supabase/index.js +2 -2
- package/dist/stacks/supabase/vite.cjs +10 -1
- package/dist/stacks/supabase/vite.d.cts +1 -1
- package/dist/stacks/supabase/vite.d.ts +1 -1
- package/dist/stacks/supabase/vite.js +21 -12
- package/dist/stacks/tanstack/index.cjs +33 -2
- package/dist/stacks/tanstack/index.d.cts +7 -4
- package/dist/stacks/tanstack/index.d.ts +7 -4
- package/dist/stacks/tanstack/index.js +33 -2
- package/dist/stacks/tanstack/vite.cjs +995 -15
- package/dist/stacks/tanstack/vite.d.cts +1 -1
- package/dist/stacks/tanstack/vite.d.ts +1 -1
- package/dist/stacks/tanstack/vite.js +1001 -21
- package/dist/testing/browser/LICENSE.ext-apps +218 -0
- package/dist/testing/browser/host.ts +151 -0
- package/dist/testing/browser/sandbox.ts +137 -0
- package/dist/testing/browser.cjs +382 -0
- package/dist/testing/browser.d.cts +46 -0
- package/dist/testing/browser.d.ts +46 -0
- package/dist/testing/browser.js +381 -0
- package/dist/testing/index.cjs +2 -1
- package/dist/testing/index.d.cts +2 -1
- package/dist/testing/index.d.ts +2 -1
- package/dist/testing/index.js +2 -1
- package/dist/testing/server.cjs +36 -0
- package/dist/testing/server.d.cts +6 -2
- package/dist/testing/server.d.ts +6 -2
- package/dist/testing/server.js +36 -1
- package/dist/{tool-result-DcNioyiI.js → tool-result-BG-HsSQu.js} +8 -1
- package/dist/{tool-result-rU-PpNNi.cjs → tool-result-BQcr7VV-.cjs} +8 -1
- package/dist/{types-z7T5bBIU.d.cts → types-B_dVw-zM.d.cts} +55 -1
- package/dist/{types-z7T5bBIU.d.ts → types-B_dVw-zM.d.ts} +55 -1
- package/package.json +66 -25
|
@@ -0,0 +1,382 @@
|
|
|
1
|
+
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
2
|
+
let node_fs = require("node:fs");
|
|
3
|
+
let node_path = require("node:path");
|
|
4
|
+
let node_crypto = require("node:crypto");
|
|
5
|
+
let esbuild = require("esbuild");
|
|
6
|
+
let node_url = require("node:url");
|
|
7
|
+
let node_http = require("node:http");
|
|
8
|
+
//#region src/testing/browser/serve.ts
|
|
9
|
+
function sanitizeCspDomains(domains) {
|
|
10
|
+
if (!domains) return [];
|
|
11
|
+
return domains.filter((d) => typeof d === "string" && !/[;\r\n'" ]/.test(d));
|
|
12
|
+
}
|
|
13
|
+
function buildReleasedSpecCsp(csp) {
|
|
14
|
+
const frameDomains = sanitizeCspDomains(csp?.frameDomains).join(" ");
|
|
15
|
+
const baseUriDomains = sanitizeCspDomains(csp?.baseUriDomains).join(" ");
|
|
16
|
+
const tail = [
|
|
17
|
+
frameDomains ? `frame-src ${frameDomains}` : "frame-src 'none'",
|
|
18
|
+
"object-src 'none'",
|
|
19
|
+
baseUriDomains ? `base-uri ${baseUriDomains}` : "base-uri 'self'"
|
|
20
|
+
];
|
|
21
|
+
if (!csp) return [
|
|
22
|
+
"default-src 'none'",
|
|
23
|
+
"script-src 'self' 'unsafe-inline'",
|
|
24
|
+
"style-src 'self' 'unsafe-inline'",
|
|
25
|
+
"img-src 'self' data:",
|
|
26
|
+
"media-src 'self' data:",
|
|
27
|
+
"connect-src 'none'",
|
|
28
|
+
...tail
|
|
29
|
+
].join("; ");
|
|
30
|
+
const resourceDomains = sanitizeCspDomains(csp.resourceDomains).join(" ");
|
|
31
|
+
const connectDomains = sanitizeCspDomains(csp.connectDomains).join(" ");
|
|
32
|
+
return [
|
|
33
|
+
"default-src 'none'",
|
|
34
|
+
`script-src 'self' 'unsafe-inline' ${resourceDomains}`.trim(),
|
|
35
|
+
`style-src 'self' 'unsafe-inline' ${resourceDomains}`.trim(),
|
|
36
|
+
`connect-src 'self' ${connectDomains}`.trim(),
|
|
37
|
+
`img-src 'self' data: ${resourceDomains}`.trim(),
|
|
38
|
+
`font-src 'self' ${resourceDomains}`.trim(),
|
|
39
|
+
`media-src 'self' data: ${resourceDomains}`.trim(),
|
|
40
|
+
...tail
|
|
41
|
+
].join("; ");
|
|
42
|
+
}
|
|
43
|
+
function buildReferenceHostCsp(csp) {
|
|
44
|
+
const resourceDomains = sanitizeCspDomains(csp?.resourceDomains).join(" ");
|
|
45
|
+
const connectDomains = sanitizeCspDomains(csp?.connectDomains).join(" ");
|
|
46
|
+
const frameDomains = sanitizeCspDomains(csp?.frameDomains).join(" ") || null;
|
|
47
|
+
const baseUriDomains = sanitizeCspDomains(csp?.baseUriDomains).join(" ") || null;
|
|
48
|
+
return [
|
|
49
|
+
"default-src 'self' 'unsafe-inline'",
|
|
50
|
+
`script-src 'self' 'unsafe-inline' 'unsafe-eval' blob: data: ${resourceDomains}`.trim(),
|
|
51
|
+
`style-src 'self' 'unsafe-inline' blob: data: ${resourceDomains}`.trim(),
|
|
52
|
+
`img-src 'self' data: blob: ${resourceDomains}`.trim(),
|
|
53
|
+
`font-src 'self' data: blob: ${resourceDomains}`.trim(),
|
|
54
|
+
`media-src 'self' data: blob: ${resourceDomains}`.trim(),
|
|
55
|
+
`connect-src 'self' ${connectDomains}`.trim(),
|
|
56
|
+
`worker-src 'self' blob: ${resourceDomains}`.trim(),
|
|
57
|
+
frameDomains ? `frame-src ${frameDomains}` : "frame-src 'none'",
|
|
58
|
+
"object-src 'none'",
|
|
59
|
+
baseUriDomains ? `base-uri ${baseUriDomains}` : "base-uri 'none'"
|
|
60
|
+
].join("; ");
|
|
61
|
+
}
|
|
62
|
+
const cspPolicies = {
|
|
63
|
+
"released-spec": buildReleasedSpecCsp,
|
|
64
|
+
"reference-host": buildReferenceHostCsp
|
|
65
|
+
};
|
|
66
|
+
const SANDBOX_HTML = `<!doctype html>
|
|
67
|
+
<html>
|
|
68
|
+
<head>
|
|
69
|
+
<meta charset="utf-8" />
|
|
70
|
+
<meta name="color-scheme" content="light dark">
|
|
71
|
+
<title>MCP-UI Proxy</title>
|
|
72
|
+
<style>
|
|
73
|
+
html, body { margin: 0; height: 100vh; width: 100vw; background-color: transparent; }
|
|
74
|
+
body { display: flex; flex-direction: column; }
|
|
75
|
+
* { box-sizing: border-box; }
|
|
76
|
+
iframe { background-color: transparent; border: 0px none transparent; padding: 0px; overflow: hidden; flex-grow: 1; color-scheme: inherit; }
|
|
77
|
+
</style>
|
|
78
|
+
</head>
|
|
79
|
+
<body>
|
|
80
|
+
<script src="/sandbox.js"><\/script>
|
|
81
|
+
</body>
|
|
82
|
+
</html>`;
|
|
83
|
+
const HOST_HTML = `<!doctype html>
|
|
84
|
+
<html>
|
|
85
|
+
<head><meta charset="utf-8" /><title>MCP Apps test host</title></head>
|
|
86
|
+
<body><script src="/host.js"><\/script></body>
|
|
87
|
+
</html>`;
|
|
88
|
+
async function bundle(entry, globalName) {
|
|
89
|
+
return (await (0, esbuild.build)({
|
|
90
|
+
entryPoints: [(0, node_url.fileURLToPath)(entry)],
|
|
91
|
+
bundle: true,
|
|
92
|
+
write: false,
|
|
93
|
+
format: "iife",
|
|
94
|
+
globalName,
|
|
95
|
+
platform: "browser",
|
|
96
|
+
plugins: [{
|
|
97
|
+
name: "fixture-bridge-compatibility",
|
|
98
|
+
setup(builder) {
|
|
99
|
+
builder.onResolve({ filter: /^@modelcontextprotocol\/ext-apps\/app-bridge$/ }, async (args) => {
|
|
100
|
+
if (args.pluginData?.bridgeResolved) return;
|
|
101
|
+
const resolved = await builder.resolve(args.path, {
|
|
102
|
+
importer: args.importer,
|
|
103
|
+
resolveDir: args.resolveDir,
|
|
104
|
+
kind: args.kind,
|
|
105
|
+
pluginData: { bridgeResolved: true }
|
|
106
|
+
});
|
|
107
|
+
if (resolved.errors.length > 0) return resolved;
|
|
108
|
+
for (let dir = (0, node_path.dirname)(resolved.path);; dir = (0, node_path.dirname)(dir)) {
|
|
109
|
+
let manifest;
|
|
110
|
+
try {
|
|
111
|
+
manifest = JSON.parse((0, node_fs.readFileSync)((0, node_path.join)(dir, "package.json"), "utf8"));
|
|
112
|
+
} catch (error) {
|
|
113
|
+
if (error.code !== "ENOENT") throw error;
|
|
114
|
+
}
|
|
115
|
+
if (manifest?.name === "@modelcontextprotocol/ext-apps") {
|
|
116
|
+
const version = String(manifest.version);
|
|
117
|
+
const stable = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:\+[\da-zA-Z-]+(?:\.[\da-zA-Z-]+)*)?$/.exec(version);
|
|
118
|
+
if (!stable || Number(stable[1]) !== 1 || Number(stable[2]) < 7 || Number(stable[2]) === 7 && Number(stable[3]) < 3) throw new Error(`MCP Apps browser fixture resolved @modelcontextprotocol/ext-apps ${version} at ${dir}; supported range is ^1.7.3 (stable releases). Preserve existing project pins; use a compatible installation for this fixture or explicitly agree a dependency change before testing.`);
|
|
119
|
+
return resolved;
|
|
120
|
+
}
|
|
121
|
+
if ((0, node_path.dirname)(dir) === dir) throw new Error(`Cannot identify the MCP Apps fixture bridge package at ${resolved.path}`);
|
|
122
|
+
}
|
|
123
|
+
});
|
|
124
|
+
}
|
|
125
|
+
}]
|
|
126
|
+
})).outputFiles[0].text;
|
|
127
|
+
}
|
|
128
|
+
function listen(server) {
|
|
129
|
+
return new Promise((resolve, reject) => {
|
|
130
|
+
server.once("error", reject);
|
|
131
|
+
server.listen(0, "127.0.0.1", () => resolve(`http://127.0.0.1:${server.address().port}`));
|
|
132
|
+
});
|
|
133
|
+
}
|
|
134
|
+
function close(server) {
|
|
135
|
+
return new Promise((resolve) => {
|
|
136
|
+
server.closeAllConnections();
|
|
137
|
+
server.close(() => resolve());
|
|
138
|
+
});
|
|
139
|
+
}
|
|
140
|
+
async function readBody(request) {
|
|
141
|
+
const chunks = [];
|
|
142
|
+
for await (const chunk of request) chunks.push(chunk);
|
|
143
|
+
return Buffer.concat(chunks);
|
|
144
|
+
}
|
|
145
|
+
function send(response, status, type, body, headers = {}) {
|
|
146
|
+
response.writeHead(status, {
|
|
147
|
+
"Content-Type": type,
|
|
148
|
+
...headers
|
|
149
|
+
});
|
|
150
|
+
response.end(body);
|
|
151
|
+
}
|
|
152
|
+
async function forward(request, body, response, origin, handler) {
|
|
153
|
+
const headers = new Headers();
|
|
154
|
+
for (const [name, value] of Object.entries(request.headers)) {
|
|
155
|
+
if ([
|
|
156
|
+
"host",
|
|
157
|
+
"connection",
|
|
158
|
+
"content-length"
|
|
159
|
+
].includes(name) || value === void 0) continue;
|
|
160
|
+
for (const item of Array.isArray(value) ? value : [value]) headers.append(name, item);
|
|
161
|
+
}
|
|
162
|
+
const method = request.method ?? "GET";
|
|
163
|
+
const result = await handler(new Request(new URL("/mcp", origin), {
|
|
164
|
+
method,
|
|
165
|
+
headers,
|
|
166
|
+
body: method === "GET" || method === "HEAD" ? void 0 : Uint8Array.from(body)
|
|
167
|
+
}));
|
|
168
|
+
response.writeHead(result.status, Object.fromEntries(result.headers));
|
|
169
|
+
if (result.body) {
|
|
170
|
+
const reader = result.body.getReader();
|
|
171
|
+
for (;;) {
|
|
172
|
+
const { done, value } = await reader.read();
|
|
173
|
+
if (done) break;
|
|
174
|
+
response.write(value);
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
response.end();
|
|
178
|
+
}
|
|
179
|
+
function parseRpc(body) {
|
|
180
|
+
try {
|
|
181
|
+
const message = JSON.parse(body.toString("utf8"));
|
|
182
|
+
return {
|
|
183
|
+
method: message?.method,
|
|
184
|
+
params: message?.params
|
|
185
|
+
};
|
|
186
|
+
} catch {
|
|
187
|
+
return;
|
|
188
|
+
}
|
|
189
|
+
}
|
|
190
|
+
/**
|
|
191
|
+
* Starts the host origin (host page + authenticated MCP endpoints) and a
|
|
192
|
+
* separate sandbox origin that serves only the proxy with an HTTP CSP header.
|
|
193
|
+
* Both bind to 127.0.0.1 on different ports, as upstream uses 8080/8081.
|
|
194
|
+
*/
|
|
195
|
+
async function startServers(assets) {
|
|
196
|
+
const [hostScript, sandboxScript] = await Promise.all([bundle(new URL("host.ts", assets), "host"), bundle(new URL("sandbox.ts", assets))]);
|
|
197
|
+
const backends = /* @__PURE__ */ new Map();
|
|
198
|
+
const hostRequests = [];
|
|
199
|
+
const sandboxRequests = [];
|
|
200
|
+
const policies = /* @__PURE__ */ new Map();
|
|
201
|
+
let hostOrigin = "";
|
|
202
|
+
const host = (0, node_http.createServer)((request, response) => {
|
|
203
|
+
const url = new URL(request.url ?? "/", hostOrigin);
|
|
204
|
+
const backend = backends.get(url.pathname);
|
|
205
|
+
if (backend) {
|
|
206
|
+
(async () => {
|
|
207
|
+
const body = await readBody(request);
|
|
208
|
+
hostRequests.push({
|
|
209
|
+
method: request.method ?? "GET",
|
|
210
|
+
path: url.pathname,
|
|
211
|
+
authorization: request.headers.authorization,
|
|
212
|
+
rpc: body.length > 0 ? parseRpc(body) : void 0
|
|
213
|
+
});
|
|
214
|
+
await forward(request, body, response, hostOrigin, backend);
|
|
215
|
+
})().catch(() => {
|
|
216
|
+
if (!response.headersSent) send(response, 500, "text/plain", "Fixture handler failed");
|
|
217
|
+
else response.end();
|
|
218
|
+
});
|
|
219
|
+
return;
|
|
220
|
+
}
|
|
221
|
+
hostRequests.push({
|
|
222
|
+
method: request.method ?? "GET",
|
|
223
|
+
path: url.pathname
|
|
224
|
+
});
|
|
225
|
+
if (url.pathname === "/") return send(response, 200, "text/html", HOST_HTML);
|
|
226
|
+
if (url.pathname === "/host.js") return send(response, 200, "text/javascript", hostScript);
|
|
227
|
+
if (url.pathname === "/sandbox.html") return send(response, 404, "text/plain", "Sandbox is served on a different origin");
|
|
228
|
+
send(response, 404, "text/plain", "Not found");
|
|
229
|
+
});
|
|
230
|
+
const sandbox = (0, node_http.createServer)((request, response) => {
|
|
231
|
+
const url = new URL(request.url ?? "/", "http://sandbox.invalid");
|
|
232
|
+
if (url.pathname === "/sandbox.js") {
|
|
233
|
+
sandboxRequests.push({ url: request.url ?? "" });
|
|
234
|
+
return send(response, 200, "text/javascript", sandboxScript);
|
|
235
|
+
}
|
|
236
|
+
if (url.pathname !== "/sandbox.html") {
|
|
237
|
+
sandboxRequests.push({ url: request.url ?? "" });
|
|
238
|
+
return send(response, 404, "text/plain", "Only sandbox.html is served on this origin");
|
|
239
|
+
}
|
|
240
|
+
const csp = policies.get(url.searchParams.get("mount") ?? "");
|
|
241
|
+
if (!csp) return send(response, 404, "text/plain", "Unknown mount");
|
|
242
|
+
sandboxRequests.push({
|
|
243
|
+
url: request.url ?? "",
|
|
244
|
+
csp
|
|
245
|
+
});
|
|
246
|
+
send(response, 200, "text/html", SANDBOX_HTML, {
|
|
247
|
+
"Content-Security-Policy": csp,
|
|
248
|
+
"Cache-Control": "no-cache, no-store, must-revalidate",
|
|
249
|
+
Pragma: "no-cache",
|
|
250
|
+
Expires: "0"
|
|
251
|
+
});
|
|
252
|
+
});
|
|
253
|
+
hostOrigin = await listen(host);
|
|
254
|
+
const sandboxOrigin = await listen(sandbox).catch(async (error) => {
|
|
255
|
+
await close(host);
|
|
256
|
+
throw error;
|
|
257
|
+
});
|
|
258
|
+
return {
|
|
259
|
+
hostOrigin,
|
|
260
|
+
sandboxOrigin,
|
|
261
|
+
registerResource(csp, policy = "released-spec") {
|
|
262
|
+
const id = (0, node_crypto.randomUUID)();
|
|
263
|
+
policies.set(id, cspPolicies[policy](csp));
|
|
264
|
+
return `${sandboxOrigin}/sandbox.html?mount=${id}`;
|
|
265
|
+
},
|
|
266
|
+
/** Mount an MCP handler at a host-origin path, e.g. `/mcp`. */
|
|
267
|
+
backends,
|
|
268
|
+
hostRequests,
|
|
269
|
+
sandboxRequests,
|
|
270
|
+
close: () => Promise.all([close(host), close(sandbox)])
|
|
271
|
+
};
|
|
272
|
+
}
|
|
273
|
+
//#endregion
|
|
274
|
+
//#region src/testing/browser.ts
|
|
275
|
+
async function createAppFixture(browser, options = {}) {
|
|
276
|
+
const servers = await startServers(new URL("./browser/", require("url").pathToFileURL(__filename).href));
|
|
277
|
+
const context = await browser.newContext({
|
|
278
|
+
viewport: options.viewport ?? {
|
|
279
|
+
width: 800,
|
|
280
|
+
height: 700
|
|
281
|
+
},
|
|
282
|
+
serviceWorkers: "block",
|
|
283
|
+
acceptDownloads: false
|
|
284
|
+
}).catch(async (error) => {
|
|
285
|
+
await servers.close();
|
|
286
|
+
throw error;
|
|
287
|
+
});
|
|
288
|
+
const pending = /* @__PURE__ */ new Map();
|
|
289
|
+
const requests = [];
|
|
290
|
+
try {
|
|
291
|
+
await context.routeWebSocket("**/*", (socket) => socket.close());
|
|
292
|
+
await context.route("**/*", (route) => {
|
|
293
|
+
const url = new URL(route.request().url());
|
|
294
|
+
return (url.origin === servers.hostOrigin && ["/", "/host.js"].includes(url.pathname) || url.origin === servers.sandboxOrigin && ["/sandbox.html", "/sandbox.js"].includes(url.pathname)) && route.request().method() === "GET" ? route.continue() : route.abort();
|
|
295
|
+
});
|
|
296
|
+
const page = await context.newPage();
|
|
297
|
+
context.on("page", (popup) => {
|
|
298
|
+
popup.close();
|
|
299
|
+
});
|
|
300
|
+
page.setDefaultTimeout(options.timeoutMs ?? 1e4);
|
|
301
|
+
await page.exposeBinding("mcpFixtureCall", async ({ frame }, id, params) => {
|
|
302
|
+
if (frame !== page.mainFrame() || frame.url() !== `${servers.hostOrigin}/`) throw new Error("Only the fixture host may call tools.");
|
|
303
|
+
requests.push(params);
|
|
304
|
+
const controller = new AbortController();
|
|
305
|
+
pending.set(id, controller);
|
|
306
|
+
try {
|
|
307
|
+
if (!options.onCallTool) return {
|
|
308
|
+
isError: true,
|
|
309
|
+
content: [{
|
|
310
|
+
type: "text",
|
|
311
|
+
text: "No test response configured for this tool call."
|
|
312
|
+
}]
|
|
313
|
+
};
|
|
314
|
+
return await options.onCallTool(params, controller.signal);
|
|
315
|
+
} catch {
|
|
316
|
+
return {
|
|
317
|
+
isError: true,
|
|
318
|
+
content: [{
|
|
319
|
+
type: "text",
|
|
320
|
+
text: "The test's tool response failed. Inspect the Node-side test."
|
|
321
|
+
}]
|
|
322
|
+
};
|
|
323
|
+
} finally {
|
|
324
|
+
pending.delete(id);
|
|
325
|
+
}
|
|
326
|
+
});
|
|
327
|
+
await page.exposeBinding("mcpFixtureCancel", ({ frame }, id) => {
|
|
328
|
+
if (frame === page.mainFrame() && frame.url() === `${servers.hostOrigin}/`) pending.get(id)?.abort();
|
|
329
|
+
});
|
|
330
|
+
await page.goto(`${servers.hostOrigin}/`);
|
|
331
|
+
return {
|
|
332
|
+
page,
|
|
333
|
+
view: page.frameLocator("iframe[title=\"MCP App\"]").frameLocator("iframe"),
|
|
334
|
+
requests,
|
|
335
|
+
async mount(resource, mount = {}) {
|
|
336
|
+
if (resource.mimeType !== "text/html;profile=mcp-app") throw new Error("Mount a UI resource with MIME text/html;profile=mcp-app.");
|
|
337
|
+
const ui = resource._meta?.ui;
|
|
338
|
+
const data = {
|
|
339
|
+
resource: {
|
|
340
|
+
text: resource.text,
|
|
341
|
+
uri: resource.uri,
|
|
342
|
+
mimeType: resource.mimeType
|
|
343
|
+
},
|
|
344
|
+
sandboxUrl: servers.registerResource(ui?.csp, mount.policy),
|
|
345
|
+
csp: ui?.csp,
|
|
346
|
+
permissions: ui?.permissions,
|
|
347
|
+
capabilities: mount.capabilities ?? { serverTools: {} },
|
|
348
|
+
context: mount.context ?? {},
|
|
349
|
+
arguments: mount.arguments,
|
|
350
|
+
result: mount.result,
|
|
351
|
+
initialize: mount.initialize
|
|
352
|
+
};
|
|
353
|
+
let timer;
|
|
354
|
+
try {
|
|
355
|
+
await Promise.race([page.evaluate((value) => host.mount(value), data), new Promise((_, reject) => {
|
|
356
|
+
timer = setTimeout(() => reject(/* @__PURE__ */ new Error("App did not initialize; inspect the view's bridge connection and browser errors.")), options.timeoutMs ?? 1e4);
|
|
357
|
+
})]);
|
|
358
|
+
} finally {
|
|
359
|
+
clearTimeout(timer);
|
|
360
|
+
}
|
|
361
|
+
},
|
|
362
|
+
deliverResult: (result) => page.evaluate((value) => host.bridge.sendToolResult(value), result),
|
|
363
|
+
updateContext: (value) => page.evaluate((value) => host.bridge.sendHostContextChange(value), value),
|
|
364
|
+
cancel: (reason) => page.evaluate((reason) => host.bridge.sendToolCancelled({ reason }), reason),
|
|
365
|
+
teardown: () => page.evaluate(() => host.teardown()),
|
|
366
|
+
settle: async () => {
|
|
367
|
+
await page.evaluate(() => host.settle());
|
|
368
|
+
},
|
|
369
|
+
async close() {
|
|
370
|
+
for (const controller of pending.values()) controller.abort();
|
|
371
|
+
await context.close();
|
|
372
|
+
await servers.close();
|
|
373
|
+
}
|
|
374
|
+
};
|
|
375
|
+
} catch (error) {
|
|
376
|
+
await context.close();
|
|
377
|
+
await servers.close();
|
|
378
|
+
throw error;
|
|
379
|
+
}
|
|
380
|
+
}
|
|
381
|
+
//#endregion
|
|
382
|
+
exports.createAppFixture = createAppFixture;
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import { McpUiHostCapabilities, McpUiHostContext } from "@modelcontextprotocol/ext-apps/app-bridge";
|
|
2
|
+
import { CallToolRequest, CallToolResult } from "@modelcontextprotocol/sdk/types.js";
|
|
3
|
+
import { Browser, FrameLocator, Page } from "playwright";
|
|
4
|
+
//#region src/testing/browser/serve.d.ts
|
|
5
|
+
type CspPolicyName = "released-spec" | "reference-host";
|
|
6
|
+
//#endregion
|
|
7
|
+
//#region src/testing/browser.d.ts
|
|
8
|
+
interface AppFixtureOptions {
|
|
9
|
+
viewport?: {
|
|
10
|
+
width: number;
|
|
11
|
+
height: number;
|
|
12
|
+
};
|
|
13
|
+
timeoutMs?: number;
|
|
14
|
+
onCallTool?: (params: CallToolRequest["params"], signal: AbortSignal) => Promise<CallToolResult>;
|
|
15
|
+
}
|
|
16
|
+
interface AppMountOptions {
|
|
17
|
+
arguments?: Record<string, unknown>;
|
|
18
|
+
result?: CallToolResult;
|
|
19
|
+
capabilities?: McpUiHostCapabilities;
|
|
20
|
+
context?: McpUiHostContext;
|
|
21
|
+
policy?: CspPolicyName;
|
|
22
|
+
initialize?: boolean;
|
|
23
|
+
}
|
|
24
|
+
interface AppResource {
|
|
25
|
+
uri: string;
|
|
26
|
+
mimeType?: string;
|
|
27
|
+
text: string;
|
|
28
|
+
_meta?: Record<string, unknown>;
|
|
29
|
+
}
|
|
30
|
+
interface AppFixture {
|
|
31
|
+
page: Page;
|
|
32
|
+
view: FrameLocator;
|
|
33
|
+
requests: CallToolRequest["params"][];
|
|
34
|
+
mount(resource: AppResource, options?: AppMountOptions): Promise<void>;
|
|
35
|
+
deliverResult(result: CallToolResult): Promise<void>;
|
|
36
|
+
updateContext(context: McpUiHostContext): Promise<void>;
|
|
37
|
+
cancel(reason: string): Promise<void>;
|
|
38
|
+
teardown(): Promise<{
|
|
39
|
+
acknowledged: boolean;
|
|
40
|
+
}>;
|
|
41
|
+
settle(): Promise<void>;
|
|
42
|
+
close(): Promise<void>;
|
|
43
|
+
}
|
|
44
|
+
declare function createAppFixture(browser: Browser, options?: AppFixtureOptions): Promise<AppFixture>;
|
|
45
|
+
//#endregion
|
|
46
|
+
export { AppFixture, AppFixtureOptions, AppMountOptions, AppResource, createAppFixture };
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import { McpUiHostCapabilities, McpUiHostContext } from "@modelcontextprotocol/ext-apps/app-bridge";
|
|
2
|
+
import { CallToolRequest, CallToolResult } from "@modelcontextprotocol/sdk/types.js";
|
|
3
|
+
import { Browser, FrameLocator, Page } from "playwright";
|
|
4
|
+
//#region src/testing/browser/serve.d.ts
|
|
5
|
+
type CspPolicyName = "released-spec" | "reference-host";
|
|
6
|
+
//#endregion
|
|
7
|
+
//#region src/testing/browser.d.ts
|
|
8
|
+
interface AppFixtureOptions {
|
|
9
|
+
viewport?: {
|
|
10
|
+
width: number;
|
|
11
|
+
height: number;
|
|
12
|
+
};
|
|
13
|
+
timeoutMs?: number;
|
|
14
|
+
onCallTool?: (params: CallToolRequest["params"], signal: AbortSignal) => Promise<CallToolResult>;
|
|
15
|
+
}
|
|
16
|
+
interface AppMountOptions {
|
|
17
|
+
arguments?: Record<string, unknown>;
|
|
18
|
+
result?: CallToolResult;
|
|
19
|
+
capabilities?: McpUiHostCapabilities;
|
|
20
|
+
context?: McpUiHostContext;
|
|
21
|
+
policy?: CspPolicyName;
|
|
22
|
+
initialize?: boolean;
|
|
23
|
+
}
|
|
24
|
+
interface AppResource {
|
|
25
|
+
uri: string;
|
|
26
|
+
mimeType?: string;
|
|
27
|
+
text: string;
|
|
28
|
+
_meta?: Record<string, unknown>;
|
|
29
|
+
}
|
|
30
|
+
interface AppFixture {
|
|
31
|
+
page: Page;
|
|
32
|
+
view: FrameLocator;
|
|
33
|
+
requests: CallToolRequest["params"][];
|
|
34
|
+
mount(resource: AppResource, options?: AppMountOptions): Promise<void>;
|
|
35
|
+
deliverResult(result: CallToolResult): Promise<void>;
|
|
36
|
+
updateContext(context: McpUiHostContext): Promise<void>;
|
|
37
|
+
cancel(reason: string): Promise<void>;
|
|
38
|
+
teardown(): Promise<{
|
|
39
|
+
acknowledged: boolean;
|
|
40
|
+
}>;
|
|
41
|
+
settle(): Promise<void>;
|
|
42
|
+
close(): Promise<void>;
|
|
43
|
+
}
|
|
44
|
+
declare function createAppFixture(browser: Browser, options?: AppFixtureOptions): Promise<AppFixture>;
|
|
45
|
+
//#endregion
|
|
46
|
+
export { AppFixture, AppFixtureOptions, AppMountOptions, AppResource, createAppFixture };
|