@mcpfn/testing 0.0.1
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.md +105 -0
- package/dist/auth.cjs +685 -0
- package/dist/auth.cjs.map +1 -0
- package/dist/auth.d.cts +199 -0
- package/dist/auth.d.ts +199 -0
- package/dist/auth.js +644 -0
- package/dist/auth.js.map +1 -0
- package/dist/index.cjs +1228 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.cts +152 -0
- package/dist/index.d.ts +152 -0
- package/dist/index.js +1171 -0
- package/dist/index.js.map +1 -0
- package/dist/playwright.cjs +574 -0
- package/dist/playwright.cjs.map +1 -0
- package/dist/playwright.d.cts +75 -0
- package/dist/playwright.d.ts +75 -0
- package/dist/playwright.js +545 -0
- package/dist/playwright.js.map +1 -0
- package/package.json +64 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/index.ts","../src/assertions.ts","../src/auth-core.ts","../src/mock-oauth-server.ts","../src/client.ts","../src/conformance.ts","../src/host-profiles.ts","../src/scenarios.ts"],"sourcesContent":["export * from \"./assertions.js\";\nexport * from \"./auth.js\";\nexport * from \"./client.js\";\nexport * from \"./conformance.js\";\nexport * from \"./host-profiles.js\";\nexport * from \"./scenarios.js\";\n","import type { Tool } from \"@modelcontextprotocol/sdk/types.js\";\nimport { UriTemplate } from \"@modelcontextprotocol/sdk/shared/uriTemplate.js\";\nimport type { McpFnManifest } from \"@mcpfn/core\";\n\nimport type { McpFnTestClient } from \"./client.js\";\n\nexport function stableJson(value: unknown): string {\n if (Array.isArray(value)) return `[${value.map(stableJson).join(\",\")}]`;\n if (value && typeof value === \"object\") {\n return `{${Object.entries(value as Record<string, unknown>)\n .filter(([, entry]) => entry !== undefined)\n .sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0)\n .map(([key, entry]) => `${JSON.stringify(key)}:${stableJson(entry)}`)\n .join(\",\")}}`;\n }\n return JSON.stringify(value);\n}\n\nexport class McpFnAssertionError extends Error {\n constructor(message: string) {\n super(message);\n this.name = \"McpFnAssertionError\";\n }\n}\n\nexport interface AssertManifestContractOptions {\n /** Exact tools expected to be visible for the test client's request context. */\n expectedToolNames?: readonly string[];\n}\n\nexport async function assertManifestContract(\n client: McpFnTestClient<unknown>,\n manifest: McpFnManifest,\n options: AssertManifestContractOptions = {},\n): Promise<Tool[]> {\n const actual = await client.listTools();\n const actualByName = new Map(actual.map((tool) => [tool.name, tool]));\n const manifestByName = new Map(manifest.tools.map((tool) => [tool.name, tool]));\n const expectedNames = [...(\n options.expectedToolNames ?? manifest.tools.map((tool) => tool.name)\n )].sort();\n const unknownExpectedNames = expectedNames.filter((name) => !manifestByName.has(name));\n if (unknownExpectedNames.length) {\n throw new McpFnAssertionError(\n `Expected visible tools are absent from the manifest: ${stableJson(unknownExpectedNames)}`,\n );\n }\n const actualNames = actual.map((tool) => tool.name).sort();\n if (stableJson(expectedNames) !== stableJson(actualNames)) {\n throw new McpFnAssertionError(\n `Tool inventory mismatch\\nexpected: ${stableJson(expectedNames)}\\nactual: ${stableJson(actualNames)}`,\n );\n }\n for (const name of expectedNames) {\n const expected = manifestByName.get(name)!;\n const tool = actualByName.get(expected.name)!;\n const comparableExpected = {\n name: expected.name,\n description: expected.description,\n inputSchema: expected.inputSchema,\n outputSchema: expected.outputSchema,\n annotations: expected.annotations,\n execution: expected.execution,\n icons: expected.icons,\n title: expected.title,\n _meta: expected.metadata,\n };\n const comparableActual = {\n name: tool.name,\n description: tool.description,\n inputSchema: tool.inputSchema,\n outputSchema: tool.outputSchema,\n annotations: tool.annotations,\n execution: tool.execution,\n icons: tool.icons,\n title: tool.title,\n _meta: tool._meta,\n };\n if (stableJson(comparableExpected) !== stableJson(comparableActual)) {\n throw new McpFnAssertionError(\n `Contract mismatch for ${expected.name}\\nexpected: ${stableJson(comparableExpected)}\\nactual: ${stableJson(comparableActual)}`,\n );\n }\n }\n\n const actualCapabilities = client.client.getServerCapabilities() ?? {};\n if (stableJson(manifest.capabilities ?? {}) !== stableJson(actualCapabilities)) {\n throw new McpFnAssertionError(\n `Capability mismatch\\nexpected: ${stableJson(manifest.capabilities ?? {})}\\nactual: ${stableJson(actualCapabilities)}`,\n );\n }\n\n const actualResources = actualCapabilities.resources\n ? await client.listResources()\n : [];\n const comparableResources = actualResources.map(({ _meta, ...resource }) => ({\n ...resource,\n metadata: _meta,\n }));\n const staticResourceUris = new Set(\n (manifest.resources ?? []).map((resource) => resource.uri),\n );\n const resourceTemplates = (manifest.resourceTemplates ?? []).map(\n (template) => new UriTemplate(template.uriTemplate),\n );\n const comparableStaticResources = comparableResources.filter(\n (resource) =>\n staticResourceUris.has(resource.uri) ||\n !resourceTemplates.some((template) => template.match(resource.uri)),\n );\n const expectedResources = (manifest.resources ?? []).map(\n ({ subscribable: _subscribable, ...resource }) => resource,\n );\n if (stableJson(expectedResources) !== stableJson(comparableStaticResources)) {\n throw new McpFnAssertionError(\n `Resource inventory mismatch\\nexpected: ${stableJson(expectedResources)}\\nactual: ${stableJson(comparableStaticResources)}`,\n );\n }\n\n const actualTemplates = actualCapabilities.resources\n ? await client.listResourceTemplates()\n : [];\n const comparableTemplates = actualTemplates.map(({ _meta, ...template }) => ({\n ...template,\n metadata: _meta,\n }));\n const expectedTemplates = (manifest.resourceTemplates ?? []).map(\n ({ subscribable: _subscribable, ...template }) => template,\n );\n if (stableJson(expectedTemplates) !== stableJson(comparableTemplates)) {\n throw new McpFnAssertionError(\n `Resource template inventory mismatch\\nexpected: ${stableJson(expectedTemplates)}\\nactual: ${stableJson(comparableTemplates)}`,\n );\n }\n\n for (const resource of comparableResources) {\n const expected = (manifest.resources ?? []).find(\n (candidate) => candidate.uri === resource.uri,\n ) ?? (manifest.resourceTemplates ?? []).find(\n (candidate) => new UriTemplate(candidate.uriTemplate).match(resource.uri),\n );\n const subscribable = expected?.subscribable === true;\n if (subscribable) {\n try {\n await client.subscribeResource(resource.uri);\n await client.unsubscribeResource(resource.uri);\n } catch (error) {\n throw new McpFnAssertionError(\n `Resource subscription mismatch for ${resource.uri}: expected subscribe and unsubscribe to succeed (${error instanceof Error ? error.message : String(error)})`,\n );\n }\n continue;\n }\n let accepted = false;\n try {\n await client.subscribeResource(resource.uri);\n accepted = true;\n await client.unsubscribeResource(resource.uri).catch(() => undefined);\n } catch {\n // Rejection is the expected behavior for a non-subscribable resource.\n }\n if (accepted) {\n throw new McpFnAssertionError(\n `Resource subscription mismatch for ${resource.uri}: expected subscribe to be rejected`,\n );\n }\n }\n\n const actualPrompts = actualCapabilities.prompts\n ? await client.listPrompts()\n : [];\n const comparablePrompts = actualPrompts.map(({ _meta, ...prompt }) => ({\n ...prompt,\n metadata: _meta,\n }));\n const expectedPrompts = (manifest.prompts ?? []).map(({ argumentsSchema: _schema, ...prompt }) => prompt);\n if (stableJson(expectedPrompts) !== stableJson(comparablePrompts)) {\n throw new McpFnAssertionError(\n `Prompt inventory mismatch\\nexpected: ${stableJson(expectedPrompts)}\\nactual: ${stableJson(comparablePrompts)}`,\n );\n }\n return actual;\n}\n\nexport function assertStructuredTextParity(result: {\n content?: unknown[];\n structuredContent?: Record<string, unknown>;\n}): void {\n if (!result.structuredContent) {\n throw new McpFnAssertionError(\"Tool result has no structuredContent\");\n }\n const text = (result.content ?? []).find(\n (entry): entry is { type: \"text\"; text: string } =>\n !!entry &&\n typeof entry === \"object\" &&\n (entry as { type?: unknown }).type === \"text\" &&\n typeof (entry as { text?: unknown }).text === \"string\",\n )?.text;\n if (!text) {\n throw new McpFnAssertionError(\"Tool result has no text content\");\n }\n let parsed: unknown;\n try {\n parsed = JSON.parse(text);\n } catch {\n throw new McpFnAssertionError(\"Tool text content is not JSON\");\n }\n if (stableJson(parsed) !== stableJson(result.structuredContent)) {\n throw new McpFnAssertionError(\n \"Tool text content and structuredContent are not equivalent\",\n );\n }\n}\n","export type McpFnAuthCredentialKind = \"api-key\" | \"oauth\";\n\nexport interface McpFnAuthCredential {\n kind: McpFnAuthCredentialKind;\n headers: HeadersInit;\n label?: string;\n dispose?(): void | Promise<void>;\n}\n\nexport interface McpFnAuthCredentialRequest {\n kind: McpFnAuthCredentialKind;\n scopes?: string[];\n resource?: string;\n expiresInSeconds?: number;\n}\n\nexport interface McpFnAuthProviderCapabilities {\n expiration?: boolean;\n resourceBinding?: boolean;\n revocation?: boolean;\n scopes?: boolean;\n}\n\n/**\n * The application-owned seam. Skillplane only needs to map this interface to\n * its existing API-key or OAuth issuance and revocation helpers.\n */\nexport interface McpFnAuthProviderAdapter {\n capabilities?: McpFnAuthProviderCapabilities;\n issue(input: McpFnAuthCredentialRequest): Promise<McpFnAuthCredential>;\n revoke?(credential: McpFnAuthCredential): void | Promise<void>;\n}\n\nexport interface McpFnAuthProbeScenario {\n name:\n | \"missing-credential\"\n | \"invalid-credential\"\n | \"valid-credential\"\n | \"insufficient-scope\"\n | \"expired-credential\"\n | \"missing-resource\"\n | \"wrong-resource\"\n | \"revoked-credential\";\n kind: McpFnAuthCredentialKind;\n}\n\nexport interface McpFnAuthTarget {\n request(\n headers: Headers,\n scenario: McpFnAuthProbeScenario,\n ): Promise<Response>;\n}\n\nexport interface McpFnAuthRegressionOptions {\n kind: McpFnAuthCredentialKind;\n provider: McpFnAuthProviderAdapter;\n target: McpFnAuthTarget;\n requiredScopes?: string[];\n resource?: string;\n wrongResource?: string;\n invalidCredentialHeaders?: HeadersInit;\n /** OAuth failures are required to advertise protected-resource metadata. */\n protectedResourceMetadataUrl?: string;\n expectedAuthenticatedStatuses?: number[];\n verifyAuthenticatedResponse?(\n response: Response,\n credential: McpFnAuthCredential,\n ): void | Promise<void>;\n}\n\nexport interface McpFnAuthScenarioResult {\n name: McpFnAuthProbeScenario[\"name\"];\n status: \"passed\" | \"failed\";\n responseStatus?: number;\n error?: string;\n}\n\nexport interface McpFnBearerChallenge {\n scheme: string;\n parameters: Record<string, string>;\n}\n\nexport class McpFnAuthAssertionError extends Error {\n constructor(message: string) {\n super(message);\n this.name = \"McpFnAuthAssertionError\";\n }\n}\n\nfunction expectedStatus(\n response: Response,\n expected: number | number[],\n name: string,\n): void {\n const statuses = Array.isArray(expected) ? expected : [expected];\n if (!statuses.includes(response.status)) {\n throw new McpFnAuthAssertionError(\n `${name} expected HTTP ${statuses.join(\" or \")}, received ${response.status}`,\n );\n }\n}\n\nexport function parseBearerChallenge(\n header: string | null,\n): McpFnBearerChallenge | undefined {\n if (!header) return undefined;\n const matches = [...header.matchAll(/(?:^|,)\\s*([A-Za-z][A-Za-z0-9_-]*)\\s+/g)];\n const selectedIndex = matches.findIndex((entry) => entry[1].toLowerCase() === \"bearer\");\n if (selectedIndex < 0) return undefined;\n const match = matches[selectedIndex];\n const start = (match.index ?? 0) + match[0].length;\n const end = matches[selectedIndex + 1]?.index ?? header.length;\n const parameters: Record<string, string> = {};\n const source = header.slice(start, end);\n const pattern = /([A-Za-z][A-Za-z0-9_-]*)\\s*=\\s*(?:\"((?:[^\"\\\\]|\\\\.)*)\"|([^,\\s]+))/g;\n for (const entry of source.matchAll(pattern)) {\n const quoted = entry[2]?.replace(/\\\\([\"\\\\])/g, \"$1\");\n parameters[entry[1]] = quoted ?? entry[3] ?? \"\";\n }\n return { scheme: match[1], parameters };\n}\n\nexport function assertBearerResourceChallenge(\n response: Response,\n expectedMetadataUrl?: string,\n): McpFnBearerChallenge {\n const challenge = parseBearerChallenge(response.headers.get(\"www-authenticate\"));\n if (!challenge || challenge.scheme.toLowerCase() !== \"bearer\") {\n throw new McpFnAuthAssertionError(\"Expected a Bearer WWW-Authenticate challenge\");\n }\n const metadataUrl = challenge.parameters.resource_metadata;\n if (!metadataUrl) {\n throw new McpFnAuthAssertionError(\n \"Bearer challenge is missing the resource_metadata parameter\",\n );\n }\n try {\n const parsed = new URL(metadataUrl);\n if (!parsed.protocol || !parsed.host) throw new Error(\"not absolute\");\n } catch {\n throw new McpFnAuthAssertionError(\n `Bearer challenge has an invalid resource_metadata URL: ${metadataUrl}`,\n );\n }\n if (expectedMetadataUrl && metadataUrl !== expectedMetadataUrl) {\n throw new McpFnAuthAssertionError(\n `Expected resource_metadata=${expectedMetadataUrl}, received ${metadataUrl}`,\n );\n }\n return challenge;\n}\n\nexport function bearerCredential(\n token: string,\n kind: McpFnAuthCredentialKind = \"oauth\",\n): McpFnAuthCredential {\n return {\n kind,\n headers: { authorization: `Bearer ${token}` },\n };\n}\n\nexport function apiKeyCredential(\n apiKey: string,\n options: { headerName?: string; scheme?: string } = {},\n): McpFnAuthCredential {\n const headerName = options.headerName ?? \"authorization\";\n const value = options.scheme === \"\"\n ? apiKey\n : `${options.scheme ?? \"Bearer\"} ${apiKey}`;\n return { kind: \"api-key\", headers: { [headerName]: value } };\n}\n\nfunction invalidHeaders(options: McpFnAuthRegressionOptions): Headers {\n return new Headers(options.invalidCredentialHeaders ?? {\n authorization: `Bearer mcpfn-invalid-${options.kind}`,\n });\n}\n\nasync function runOne(\n options: McpFnAuthRegressionOptions,\n scenario: McpFnAuthProbeScenario,\n prepare: () => Promise<McpFnAuthCredential | undefined>,\n expected: number | number[],\n): Promise<McpFnAuthScenarioResult> {\n let credential: McpFnAuthCredential | undefined;\n try {\n credential = await prepare();\n const headers = credential\n ? new Headers(credential.headers)\n : scenario.name === \"invalid-credential\"\n ? invalidHeaders(options)\n : new Headers();\n const response = await options.target.request(headers, scenario);\n expectedStatus(response, expected, scenario.name);\n if (\n options.kind === \"oauth\" &&\n scenario.name !== \"valid-credential\"\n ) {\n assertBearerResourceChallenge(\n response,\n options.protectedResourceMetadataUrl,\n );\n }\n if (scenario.name === \"valid-credential\" && credential) {\n await options.verifyAuthenticatedResponse?.(response.clone(), credential);\n }\n return {\n name: scenario.name,\n status: \"passed\",\n responseStatus: response.status,\n };\n } catch (error) {\n return {\n name: scenario.name,\n status: \"failed\",\n error: error instanceof Error ? error.message : String(error),\n };\n } finally {\n await credential?.dispose?.();\n }\n}\n\n/** Runs the common API-key or OAuth resource-server regression matrix. */\nexport async function runAuthRegressionSuite(\n options: McpFnAuthRegressionOptions,\n): Promise<McpFnAuthScenarioResult[]> {\n const issue = (overrides: Partial<McpFnAuthCredentialRequest> = {}) =>\n options.provider.issue({\n kind: options.kind,\n scopes: options.requiredScopes,\n resource: options.resource,\n ...overrides,\n });\n const results: McpFnAuthScenarioResult[] = [];\n results.push(await runOne(\n options,\n { name: \"missing-credential\", kind: options.kind },\n async () => undefined,\n 401,\n ));\n results.push(await runOne(\n options,\n { name: \"invalid-credential\", kind: options.kind },\n async () => undefined,\n 401,\n ));\n results.push(await runOne(\n options,\n { name: \"valid-credential\", kind: options.kind },\n () => issue(),\n options.expectedAuthenticatedStatuses ?? [200, 201, 202, 204],\n ));\n\n const capabilities = options.provider.capabilities ?? {};\n if (capabilities.scopes && options.requiredScopes?.length) {\n results.push(await runOne(\n options,\n { name: \"insufficient-scope\", kind: options.kind },\n () => issue({ scopes: [] }),\n 403,\n ));\n }\n if (capabilities.expiration) {\n results.push(await runOne(\n options,\n { name: \"expired-credential\", kind: options.kind },\n () => issue({ expiresInSeconds: -60 }),\n 401,\n ));\n }\n if (capabilities.resourceBinding && options.resource) {\n results.push(await runOne(\n options,\n { name: \"missing-resource\", kind: options.kind },\n () => issue({ resource: undefined }),\n 401,\n ));\n }\n if (capabilities.resourceBinding && options.wrongResource) {\n results.push(await runOne(\n options,\n { name: \"wrong-resource\", kind: options.kind },\n () => issue({ resource: options.wrongResource }),\n 401,\n ));\n }\n if (capabilities.revocation && options.provider.revoke) {\n results.push(await runOne(\n options,\n { name: \"revoked-credential\", kind: options.kind },\n async () => {\n const credential = await issue();\n await options.provider.revoke?.(credential);\n return credential;\n },\n 401,\n ));\n }\n return results;\n}\n\nexport async function assertAuthRegressionSuite(\n options: McpFnAuthRegressionOptions,\n): Promise<McpFnAuthScenarioResult[]> {\n const results = await runAuthRegressionSuite(options);\n const failures = results.filter((result) => result.status === \"failed\");\n if (failures.length) {\n throw new McpFnAuthAssertionError(\n failures.map((failure) => `${failure.name}: ${failure.error}`).join(\"\\n\"),\n );\n }\n return results;\n}\n\nexport interface McpFnFetchAuthTargetOptions {\n url: string | URL;\n fetch?: typeof globalThis.fetch;\n requestInit?: RequestInit | ((scenario: McpFnAuthProbeScenario) => RequestInit);\n}\n\n/** Creates a protected MCP initialize probe suitable for local or deployed endpoints. */\nexport function createFetchAuthTarget(\n options: McpFnFetchAuthTargetOptions,\n): McpFnAuthTarget {\n const fetchImplementation = options.fetch ?? globalThis.fetch;\n if (!fetchImplementation) {\n throw new Error(\"A fetch implementation is required\");\n }\n return {\n async request(authHeaders, scenario) {\n const configured = typeof options.requestInit === \"function\"\n ? options.requestInit(scenario)\n : options.requestInit ?? {};\n const headers = new Headers(configured.headers);\n headers.set(\"accept\", \"application/json, text/event-stream\");\n headers.set(\"content-type\", \"application/json\");\n authHeaders.forEach((value, name) => headers.set(name, value));\n return fetchImplementation(options.url, {\n method: \"POST\",\n body: JSON.stringify({\n jsonrpc: \"2.0\",\n id: `mcpfn-auth-${scenario.name}`,\n method: \"initialize\",\n params: {\n protocolVersion: \"2025-11-25\",\n capabilities: {},\n clientInfo: { name: \"mcpfn-auth-test\", version: \"1.0.0\" },\n },\n }),\n ...configured,\n headers,\n });\n },\n };\n}\n\nexport const MCPFN_OAUTH_EXTENSION_GRANTS = {\n jwtBearer: \"urn:ietf:params:oauth:grant-type:jwt-bearer\",\n deviceCode: \"urn:ietf:params:oauth:grant-type:device_code\",\n generic: \"urn:example:params:oauth:grant-type:extension\",\n} as const;\n\nexport interface McpFnOAuthClientMetadata extends Record<string, unknown> {\n client_id: string;\n client_name?: string;\n redirect_uris: string[];\n response_types: string[];\n grant_types: string[];\n token_endpoint_auth_method: string;\n}\n\nexport interface McpFnOAuthClientMetadataFixtureOptions {\n clientId: string;\n redirectUris: string[];\n clientName?: string;\n extraGrantTypes?: string[];\n extraMetadata?: Record<string, unknown>;\n}\n\nexport interface McpFnOAuthClientMetadataVariants {\n basic: McpFnOAuthClientMetadata;\n jwtBearerExtension: McpFnOAuthClientMetadata;\n deviceCodeExtension: McpFnOAuthClientMetadata;\n genericExtension: McpFnOAuthClientMetadata;\n}\n\nexport function createOAuthClientMetadataFixture(\n options: McpFnOAuthClientMetadataFixtureOptions,\n): McpFnOAuthClientMetadata {\n return {\n ...options.extraMetadata,\n client_id: new URL(options.clientId).toString(),\n client_name: options.clientName ?? \"McpFn OAuth test client\",\n redirect_uris: [...new Set(options.redirectUris.map((uri) => new URL(uri).toString()))],\n response_types: [\"code\"],\n grant_types: [\n \"authorization_code\",\n \"refresh_token\",\n ...new Set(options.extraGrantTypes ?? []),\n ],\n token_endpoint_auth_method: \"none\",\n };\n}\n\nexport function createOAuthClientMetadataVariants(\n baseUrl: string | URL,\n redirectUri = new URL(\"/callback\", baseUrl).toString(),\n): McpFnOAuthClientMetadataVariants {\n const base = new URL(baseUrl);\n const fixture = (name: string, extraGrantTypes: string[] = []) =>\n createOAuthClientMetadataFixture({\n clientId: new URL(`/client-metadata/${name}`, base).toString(),\n redirectUris: [redirectUri],\n clientName: `McpFn ${name} client`,\n extraGrantTypes,\n });\n return {\n basic: fixture(\"basic\"),\n jwtBearerExtension: fixture(\"jwt-bearer-extension\", [MCPFN_OAUTH_EXTENSION_GRANTS.jwtBearer]),\n deviceCodeExtension: fixture(\"device-code-extension\", [MCPFN_OAUTH_EXTENSION_GRANTS.deviceCode]),\n genericExtension: fixture(\"generic-extension\", [MCPFN_OAUTH_EXTENSION_GRANTS.generic]),\n };\n}\n\n/**\n * Validates compatibility with authorization-code + PKCE without applying a\n * closed-world allowlist to unrelated grant types advertised by the client.\n */\nexport function assertAuthorizationCodeClientMetadata(\n metadata: McpFnOAuthClientMetadata,\n expectedClientId?: string,\n): McpFnOAuthClientMetadata {\n if (expectedClientId && metadata.client_id !== new URL(expectedClientId).toString()) {\n throw new McpFnAuthAssertionError(\"OAuth client metadata client_id does not match its document URL\");\n }\n if (!metadata.response_types.includes(\"code\")) {\n throw new McpFnAuthAssertionError(\"OAuth client metadata does not support response_type=code\");\n }\n if (!metadata.grant_types.includes(\"authorization_code\")) {\n throw new McpFnAuthAssertionError(\"OAuth client metadata does not support authorization_code\");\n }\n if (!metadata.redirect_uris.length) {\n throw new McpFnAuthAssertionError(\"OAuth client metadata must declare at least one redirect URI\");\n }\n return metadata;\n}\n","import { createHash, randomBytes, randomUUID } from \"node:crypto\";\nimport { createServer, type IncomingMessage, type ServerResponse } from \"node:http\";\nimport type { AddressInfo } from \"node:net\";\n\nimport type { AuthInfo } from \"@modelcontextprotocol/sdk/server/auth/types.js\";\n\nimport {\n assertAuthorizationCodeClientMetadata,\n createOAuthClientMetadataVariants,\n type McpFnOAuthClientMetadataVariants,\n} from \"./auth-core.js\";\n\ninterface AuthorizationCodeRecord {\n clientId: string;\n redirectUri: string;\n codeChallenge: string;\n scopes: string[];\n resource?: string;\n expiresAt: number;\n used: boolean;\n}\n\ninterface AccessTokenRecord {\n clientId: string;\n scopes: string[];\n resource?: string;\n expiresAt: number;\n revoked: boolean;\n}\n\ninterface RefreshTokenRecord {\n clientId: string;\n scopes: string[];\n resource?: string;\n expiresAt: number;\n revoked: boolean;\n}\n\nexport interface McpFnMockOAuthServerOptions {\n issuer: string | URL;\n clientId?: string;\n redirectUris?: string[];\n scopesSupported?: string[];\n accessTokenLifetimeSeconds?: number;\n authorizationCodeLifetimeSeconds?: number;\n refreshTokenLifetimeSeconds?: number;\n clock?: () => number;\n}\n\nexport interface McpFnMockOAuthTokenSet {\n access_token: string;\n token_type: \"Bearer\";\n expires_in: number;\n refresh_token: string;\n scope: string;\n resource?: string;\n}\n\nexport interface McpFnPkcePair {\n verifier: string;\n challenge: string;\n method: \"S256\";\n}\n\nexport interface McpFnOAuthCallback {\n url: string;\n parameters: Record<string, string>;\n}\n\nfunction base64Url(value: Buffer): string {\n return value.toString(\"base64url\");\n}\n\nexport function createPkcePair(): McpFnPkcePair {\n const verifier = base64Url(randomBytes(48));\n return {\n verifier,\n challenge: createHash(\"sha256\").update(verifier).digest(\"base64url\"),\n method: \"S256\",\n };\n}\n\nfunction uniqueScopes(value: string | null | undefined): string[] {\n return [...new Set((value ?? \"\").split(/\\s+/).filter(Boolean))].sort();\n}\n\nfunction json(status: number, body: unknown): Response {\n return Response.json(body, {\n status,\n headers: { \"cache-control\": \"no-store\" },\n });\n}\n\nfunction oauthError(status: number, error: string, description: string): Response {\n return json(status, { error, error_description: description });\n}\n\nfunction escapeHtml(value: string): string {\n return value\n .replaceAll(\"&\", \"&\")\n .replaceAll('\"', \""\")\n .replaceAll(\"<\", \"<\")\n .replaceAll(\">\", \">\");\n}\n\nfunction formValue(form: URLSearchParams, name: string): string | undefined {\n const value = form.get(name);\n return value === null || value === \"\" ? undefined : value;\n}\n\nexport class McpFnMockOAuthAuthorizationServer {\n readonly issuer: URL;\n readonly clientId: string;\n readonly redirectUris: string[];\n readonly scopesSupported: string[];\n readonly clientMetadata: McpFnOAuthClientMetadataVariants;\n\n private readonly codes = new Map<string, AuthorizationCodeRecord>();\n private readonly accessTokens = new Map<string, AccessTokenRecord>();\n private readonly refreshTokens = new Map<string, RefreshTokenRecord>();\n private readonly callbacks: McpFnOAuthCallback[] = [];\n private readonly clock: () => number;\n private readonly accessTokenLifetimeSeconds: number;\n private readonly authorizationCodeLifetimeSeconds: number;\n private readonly refreshTokenLifetimeSeconds: number;\n\n constructor(options: McpFnMockOAuthServerOptions) {\n this.issuer = new URL(options.issuer);\n this.issuer.pathname = this.issuer.pathname.replace(/\\/?$/, \"/\");\n this.clientId = options.clientId ?? \"mcpfn-playwright\";\n this.redirectUris = options.redirectUris?.map((uri) => new URL(uri).toString()) ?? [\n new URL(\"callback\", this.issuer).toString(),\n ];\n this.scopesSupported = [...new Set(options.scopesSupported ?? [\"mcp:read\", \"mcp:write\"])].sort();\n this.clock = options.clock ?? Date.now;\n this.accessTokenLifetimeSeconds = options.accessTokenLifetimeSeconds ?? 300;\n this.authorizationCodeLifetimeSeconds = options.authorizationCodeLifetimeSeconds ?? 120;\n this.refreshTokenLifetimeSeconds = options.refreshTokenLifetimeSeconds ?? 3_600;\n this.clientMetadata = createOAuthClientMetadataVariants(\n this.issuer,\n this.redirectUris[0],\n );\n }\n\n get metadataUrl(): string {\n return new URL(\".well-known/oauth-authorization-server\", this.issuer).toString();\n }\n\n get authorizationEndpoint(): string {\n return new URL(\"authorize\", this.issuer).toString();\n }\n\n get tokenEndpoint(): string {\n return new URL(\"token\", this.issuer).toString();\n }\n\n get revocationEndpoint(): string {\n return new URL(\"revoke\", this.issuer).toString();\n }\n\n get callbackUrl(): string {\n return this.redirectUris[0];\n }\n\n clientMetadataUrl(\n variant: keyof McpFnOAuthClientMetadataVariants,\n ): string {\n return this.clientMetadata[variant].client_id;\n }\n\n authorizationUrl(input: {\n clientId?: string;\n redirectUri?: string;\n codeChallenge: string;\n state?: string;\n scopes?: string[];\n resource?: string;\n extraParameters?: Record<string, string>;\n }): string {\n const url = new URL(this.authorizationEndpoint);\n url.searchParams.set(\"response_type\", \"code\");\n url.searchParams.set(\"client_id\", input.clientId ?? this.clientId);\n url.searchParams.set(\"redirect_uri\", input.redirectUri ?? this.callbackUrl);\n url.searchParams.set(\"code_challenge\", input.codeChallenge);\n url.searchParams.set(\"code_challenge_method\", \"S256\");\n url.searchParams.set(\"scope\", (input.scopes ?? [\"mcp:read\"]).join(\" \"));\n if (input.state) url.searchParams.set(\"state\", input.state);\n if (input.resource) url.searchParams.set(\"resource\", input.resource);\n for (const [name, value] of Object.entries(input.extraParameters ?? {})) {\n url.searchParams.set(name, value);\n }\n return url.toString();\n }\n\n latestCallback(): McpFnOAuthCallback | undefined {\n return this.callbacks.at(-1);\n }\n\n expireAccessToken(token: string): void {\n const record = this.accessTokens.get(token);\n if (record) record.expiresAt = this.nowSeconds() - 1;\n }\n\n revokeToken(token: string): void {\n const access = this.accessTokens.get(token);\n if (access) access.revoked = true;\n const refresh = this.refreshTokens.get(token);\n if (refresh) refresh.revoked = true;\n }\n\n async verifyAccessToken(token: string): Promise<AuthInfo> {\n const record = this.accessTokens.get(token);\n if (!record || record.revoked || record.expiresAt <= this.nowSeconds()) {\n throw new Error(\"Invalid access token\");\n }\n return {\n token,\n clientId: record.clientId,\n scopes: record.scopes,\n expiresAt: record.expiresAt,\n ...(record.resource ? { resource: new URL(record.resource) } : {}),\n };\n }\n\n async handle(request: Request): Promise<Response> {\n const url = new URL(request.url);\n const path = url.pathname.replace(this.issuer.pathname.replace(/\\/$/, \"\"), \"\") || \"/\";\n if (request.method === \"GET\" && path === \"/.well-known/oauth-authorization-server\") {\n return json(200, {\n issuer: this.issuer.toString(),\n authorization_endpoint: this.authorizationEndpoint,\n token_endpoint: this.tokenEndpoint,\n revocation_endpoint: this.revocationEndpoint,\n response_types_supported: [\"code\"],\n grant_types_supported: [\"authorization_code\", \"refresh_token\"],\n code_challenge_methods_supported: [\"S256\"],\n token_endpoint_auth_methods_supported: [\"none\"],\n scopes_supported: this.scopesSupported,\n });\n }\n\n if (request.method === \"GET\" && path.startsWith(\"/client-metadata/\")) {\n const metadata = Object.values(this.clientMetadata)\n .find((candidate) => new URL(candidate.client_id).pathname === url.pathname);\n return metadata ? json(200, metadata) : json(404, { error: \"not_found\" });\n }\n\n if (request.method === \"GET\" && path === \"/authorize\") {\n return this.authorize(url);\n }\n if (request.method === \"POST\" && path === \"/token\") {\n return this.token(await request.text());\n }\n if (request.method === \"POST\" && path === \"/revoke\") {\n return this.revoke(await request.text());\n }\n if (request.method === \"GET\" && path === \"/callback\") {\n const parameters = Object.fromEntries(url.searchParams);\n this.callbacks.push({ url: url.toString(), parameters });\n return new Response(\n `<!doctype html><html><body><main><h1>OAuth callback received</h1><pre>${escapeHtml(JSON.stringify(parameters, null, 2))}</pre></main></body></html>`,\n { headers: { \"content-type\": \"text/html; charset=utf-8\" } },\n );\n }\n return json(404, { error: \"not_found\" });\n }\n\n private nowSeconds(): number {\n return Math.floor(this.clock() / 1_000);\n }\n\n private resolveClient(clientId: string): { clientId: string; redirectUris: string[] } | undefined {\n if (clientId === this.clientId) {\n return { clientId, redirectUris: this.redirectUris };\n }\n const metadata = Object.values(this.clientMetadata)\n .find((candidate) => candidate.client_id === clientId);\n if (!metadata) return undefined;\n assertAuthorizationCodeClientMetadata(metadata, clientId);\n return { clientId, redirectUris: metadata.redirect_uris };\n }\n\n private authorize(url: URL): Response {\n const clientId = url.searchParams.get(\"client_id\") ?? \"\";\n const redirectUri = url.searchParams.get(\"redirect_uri\") ?? \"\";\n const client = this.resolveClient(clientId);\n if (!client) return oauthError(400, \"invalid_client\", \"Unknown OAuth client\");\n if (!client.redirectUris.includes(redirectUri)) {\n return oauthError(400, \"invalid_request\", \"redirect_uri is not registered\");\n }\n if (url.searchParams.get(\"response_type\") !== \"code\") {\n return this.authorizationRedirect(url, redirectUri, \"unsupported_response_type\");\n }\n const codeChallenge = url.searchParams.get(\"code_challenge\");\n if (!codeChallenge || url.searchParams.get(\"code_challenge_method\") !== \"S256\") {\n return this.authorizationRedirect(url, redirectUri, \"invalid_request\", \"PKCE S256 is required\");\n }\n const requestedScopes = uniqueScopes(url.searchParams.get(\"scope\"));\n if (requestedScopes.some((scope) => !this.scopesSupported.includes(scope))) {\n return this.authorizationRedirect(url, redirectUri, \"invalid_scope\");\n }\n const decision = url.searchParams.get(\"decision\");\n if (!decision) {\n const hidden = [...url.searchParams]\n .filter(([name]) => name !== \"decision\")\n .map(([name, value]) => `<input type=\"hidden\" name=\"${escapeHtml(name)}\" value=\"${escapeHtml(value)}\">`)\n .join(\"\");\n return new Response(\n `<!doctype html><html><body><main><h1>Authorize MCP client</h1><p>${escapeHtml(clientId)}</p><form method=\"get\" action=\"${escapeHtml(this.authorizationEndpoint)}\">${hidden}<button name=\"decision\" value=\"approve\">Approve</button><button name=\"decision\" value=\"deny\">Deny</button></form></main></body></html>`,\n { headers: { \"content-type\": \"text/html; charset=utf-8\", \"cache-control\": \"no-store\" } },\n );\n }\n if (decision === \"deny\") {\n return this.authorizationRedirect(url, redirectUri, \"access_denied\");\n }\n if (decision !== \"approve\") {\n return oauthError(400, \"invalid_request\", \"Unknown authorization decision\");\n }\n const code = `mcpfn_code_${randomUUID()}`;\n this.codes.set(code, {\n clientId,\n redirectUri,\n codeChallenge,\n scopes: requestedScopes,\n resource: url.searchParams.get(\"resource\") ?? undefined,\n expiresAt: this.nowSeconds() + this.authorizationCodeLifetimeSeconds,\n used: false,\n });\n const callback = new URL(redirectUri);\n callback.searchParams.set(\"code\", code);\n const state = url.searchParams.get(\"state\");\n if (state) callback.searchParams.set(\"state\", state);\n return Response.redirect(callback, 302);\n }\n\n private authorizationRedirect(\n requestUrl: URL,\n redirectUri: string,\n error: string,\n description?: string,\n ): Response {\n const callback = new URL(redirectUri);\n callback.searchParams.set(\"error\", error);\n if (description) callback.searchParams.set(\"error_description\", description);\n const state = requestUrl.searchParams.get(\"state\");\n if (state) callback.searchParams.set(\"state\", state);\n return Response.redirect(callback, 302);\n }\n\n private token(source: string): Response {\n const form = new URLSearchParams(source);\n const grantType = formValue(form, \"grant_type\");\n if (grantType === \"authorization_code\") return this.exchangeAuthorizationCode(form);\n if (grantType === \"refresh_token\") return this.exchangeRefreshToken(form);\n return oauthError(400, \"unsupported_grant_type\", \"The grant type is not supported\");\n }\n\n private exchangeAuthorizationCode(form: URLSearchParams): Response {\n const code = formValue(form, \"code\");\n const record = code ? this.codes.get(code) : undefined;\n if (!record || record.used || record.expiresAt <= this.nowSeconds()) {\n return oauthError(400, \"invalid_grant\", \"Authorization code is invalid or expired\");\n }\n if (\n formValue(form, \"client_id\") !== record.clientId ||\n formValue(form, \"redirect_uri\") !== record.redirectUri\n ) {\n return oauthError(400, \"invalid_grant\", \"Authorization code binding does not match\");\n }\n const verifier = formValue(form, \"code_verifier\");\n const challenge = verifier\n ? createHash(\"sha256\").update(verifier).digest(\"base64url\")\n : undefined;\n if (challenge !== record.codeChallenge) {\n return oauthError(400, \"invalid_grant\", \"PKCE verification failed\");\n }\n record.used = true;\n return json(200, this.issueTokenSet(record));\n }\n\n private exchangeRefreshToken(form: URLSearchParams): Response {\n const refreshToken = formValue(form, \"refresh_token\");\n const record = refreshToken ? this.refreshTokens.get(refreshToken) : undefined;\n if (!record || record.revoked || record.expiresAt <= this.nowSeconds()) {\n return oauthError(400, \"invalid_grant\", \"Refresh token is invalid or expired\");\n }\n if (formValue(form, \"client_id\") !== record.clientId) {\n return oauthError(400, \"invalid_grant\", \"Refresh token client binding does not match\");\n }\n const requestedScopes = form.has(\"scope\")\n ? uniqueScopes(form.get(\"scope\"))\n : record.scopes;\n if (requestedScopes.some((scope) => !record.scopes.includes(scope))) {\n return oauthError(400, \"invalid_scope\", \"Refresh cannot increase granted scopes\");\n }\n record.revoked = true;\n return json(200, this.issueTokenSet({ ...record, scopes: requestedScopes }));\n }\n\n private issueTokenSet(\n input: Pick<AccessTokenRecord, \"clientId\" | \"scopes\" | \"resource\">,\n ): McpFnMockOAuthTokenSet {\n const accessToken = `mcpfn_access_${randomUUID()}`;\n const refreshToken = `mcpfn_refresh_${randomUUID()}`;\n this.accessTokens.set(accessToken, {\n ...input,\n expiresAt: this.nowSeconds() + this.accessTokenLifetimeSeconds,\n revoked: false,\n });\n this.refreshTokens.set(refreshToken, {\n ...input,\n expiresAt: this.nowSeconds() + this.refreshTokenLifetimeSeconds,\n revoked: false,\n });\n return {\n access_token: accessToken,\n token_type: \"Bearer\",\n expires_in: this.accessTokenLifetimeSeconds,\n refresh_token: refreshToken,\n scope: input.scopes.join(\" \"),\n ...(input.resource ? { resource: input.resource } : {}),\n };\n }\n\n private revoke(source: string): Response {\n const token = new URLSearchParams(source).get(\"token\");\n if (token) this.revokeToken(token);\n return new Response(null, { status: 200 });\n }\n}\n\nexport interface McpFnStartedMockOAuthServer {\n origin: string;\n oauth: McpFnMockOAuthAuthorizationServer;\n close(): Promise<void>;\n}\n\nexport interface McpFnStartMockOAuthServerOptions\n extends Omit<McpFnMockOAuthServerOptions, \"issuer\"> {\n hostname?: string;\n port?: number;\n}\n\nasync function toRequest(req: IncomingMessage, origin: string): Promise<Request> {\n const chunks: Buffer[] = [];\n for await (const chunk of req) chunks.push(Buffer.from(chunk));\n const headers = new Headers();\n for (const [name, value] of Object.entries(req.headers)) {\n if (Array.isArray(value)) {\n for (const entry of value) headers.append(name, entry);\n } else if (value !== undefined) {\n headers.set(name, value);\n }\n }\n const body = chunks.length ? Buffer.concat(chunks) : undefined;\n const init: RequestInit & { duplex?: \"half\" } = {\n method: req.method,\n headers,\n ...(body ? { body, duplex: \"half\" } : {}),\n };\n return new Request(new URL(req.url ?? \"/\", origin), init);\n}\n\nasync function writeResponse(res: ServerResponse, response: Response): Promise<void> {\n res.statusCode = response.status;\n response.headers.forEach((value, name) => res.setHeader(name, value));\n res.end(Buffer.from(await response.arrayBuffer()));\n}\n\nexport async function startMockOAuthAuthorizationServer(\n options: McpFnStartMockOAuthServerOptions = {},\n): Promise<McpFnStartedMockOAuthServer> {\n let oauth: McpFnMockOAuthAuthorizationServer | undefined;\n let origin = \"\";\n const server = createServer(async (req, res) => {\n try {\n if (!oauth) throw new Error(\"Mock OAuth server is not initialized\");\n await writeResponse(res, await oauth.handle(await toRequest(req, origin)));\n } catch {\n res.statusCode = 500;\n res.setHeader(\"content-type\", \"application/json\");\n res.end(JSON.stringify({\n error: \"server_error\",\n error_description: \"Internal Server Error\",\n }));\n }\n });\n await new Promise<void>((resolve, reject) => {\n server.once(\"error\", reject);\n server.listen(options.port ?? 0, options.hostname ?? \"127.0.0.1\", () => {\n server.off(\"error\", reject);\n resolve();\n });\n });\n const address = server.address() as AddressInfo;\n origin = `http://${address.address.includes(\":\") ? `[${address.address}]` : address.address}:${address.port}`;\n oauth = new McpFnMockOAuthAuthorizationServer({ ...options, issuer: origin });\n return {\n origin,\n oauth,\n close: () => new Promise<void>((resolve, reject) => {\n server.close((error) => error ? reject(error) : resolve());\n }),\n };\n}\n","import { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { InMemoryTransport } from \"@modelcontextprotocol/sdk/inMemory.js\";\nimport type {\n CallToolResult,\n ClientCapabilities,\n CompleteRequest,\n CompleteResult,\n CreateTaskResult,\n GetPromptResult,\n ListTasksResult,\n Prompt,\n ReadResourceResult,\n Resource,\n ResourceTemplate,\n Task,\n Tool,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport {\n CallToolResultSchema,\n CreateTaskResultSchema,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport type { McpFnServer } from \"@mcpfn/core\";\n\nexport interface McpFnTestClientOptions {\n capabilities?: ClientCapabilities;\n /** Install roots, sampling, elicitation, or notification handlers before initialize. */\n configure?(client: Client): void | Promise<void>;\n}\n\nexport class McpFnTestClient<TContext = undefined> {\n readonly client: Client;\n private readonly server: McpFnServer<TContext>;\n private closed = false;\n\n private constructor(client: Client, server: McpFnServer<TContext>) {\n this.client = client;\n this.server = server;\n }\n\n static async connect<TContext>(\n server: McpFnServer<TContext>,\n info = { name: \"mcpfn-test-client\", version: \"1.0.0\" },\n options: McpFnTestClientOptions = {},\n ): Promise<McpFnTestClient<TContext>> {\n const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();\n const client = new Client(info, { capabilities: options.capabilities ?? {} });\n await options.configure?.(client);\n await server.connect(serverTransport);\n await client.connect(clientTransport);\n return new McpFnTestClient(client, server);\n }\n\n async listTools(): Promise<Tool[]> {\n const values: Tool[] = [];\n let cursor: string | undefined;\n do {\n const page = await this.client.listTools(cursor ? { cursor } : undefined);\n values.push(...page.tools);\n cursor = page.nextCursor;\n } while (cursor);\n return values;\n }\n\n async callTool(\n name: string,\n args: Record<string, unknown> = {},\n ): Promise<CallToolResult> {\n return (await this.client.callTool({ name, arguments: args })) as CallToolResult;\n }\n\n async createToolTask(\n name: string,\n args: Record<string, unknown> = {},\n options: { ttl?: number } = {},\n ): Promise<CreateTaskResult> {\n return this.client.request(\n {\n method: \"tools/call\",\n params: { name, arguments: args, task: options },\n },\n CreateTaskResultSchema,\n );\n }\n\n getTask(taskId: string): Promise<Task> {\n return this.client.experimental.tasks.getTask(taskId);\n }\n\n getTaskResult(taskId: string): Promise<CallToolResult> {\n return this.client.experimental.tasks.getTaskResult(\n taskId,\n CallToolResultSchema,\n ) as Promise<CallToolResult>;\n }\n\n listTasks(cursor?: string): Promise<ListTasksResult> {\n return this.client.experimental.tasks.listTasks(cursor);\n }\n\n cancelTask(taskId: string): Promise<Task> {\n return this.client.experimental.tasks.cancelTask(taskId);\n }\n\n async listResources(): Promise<Resource[]> {\n const values: Resource[] = [];\n let cursor: string | undefined;\n do {\n const page = await this.client.listResources(cursor ? { cursor } : undefined);\n values.push(...page.resources);\n cursor = page.nextCursor;\n } while (cursor);\n return values;\n }\n\n async listResourceTemplates(): Promise<ResourceTemplate[]> {\n const values: ResourceTemplate[] = [];\n let cursor: string | undefined;\n do {\n const page = await this.client.listResourceTemplates(cursor ? { cursor } : undefined);\n values.push(...page.resourceTemplates);\n cursor = page.nextCursor;\n } while (cursor);\n return values;\n }\n\n readResource(uri: string): Promise<ReadResourceResult> {\n return this.client.readResource({ uri });\n }\n\n async subscribeResource(uri: string): Promise<void> {\n await this.client.subscribeResource({ uri });\n }\n\n async unsubscribeResource(uri: string): Promise<void> {\n await this.client.unsubscribeResource({ uri });\n }\n\n async listPrompts(): Promise<Prompt[]> {\n const values: Prompt[] = [];\n let cursor: string | undefined;\n do {\n const page = await this.client.listPrompts(cursor ? { cursor } : undefined);\n values.push(...page.prompts);\n cursor = page.nextCursor;\n } while (cursor);\n return values;\n }\n\n getPrompt(\n name: string,\n args?: Record<string, string>,\n ): Promise<GetPromptResult> {\n return this.client.getPrompt({ name, ...(args ? { arguments: args } : {}) });\n }\n\n complete(params: CompleteRequest[\"params\"]): Promise<CompleteResult> {\n return this.client.complete(params);\n }\n\n async close(): Promise<void> {\n if (this.closed) return;\n this.closed = true;\n await this.client.close().catch(() => undefined);\n await this.server.close().catch(() => undefined);\n }\n}\n","import { spawn } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport path from \"node:path\";\n\nexport const OFFICIAL_CONFORMANCE_VERSION = \"0.1.16\";\n\nexport interface OfficialConformanceOptions {\n url: string;\n suite?: \"active\" | \"all\" | \"pending\";\n scenario?: string;\n expectedFailures?: string;\n outputDir?: string;\n specVersion?: string;\n verbose?: boolean;\n cwd?: string;\n stdio?: \"inherit\" | \"pipe\";\n}\n\nexport interface OfficialConformanceResult {\n exitCode: number;\n stdout: string;\n stderr: string;\n}\n\nfunction npxInvocation(args: string[]): { command: string; args: string[] } {\n if (process.platform !== \"win32\") return { command: \"npx\", args };\n const npmExecPath = process.env.npm_execpath;\n const candidates = [\n npmExecPath ? path.join(path.dirname(npmExecPath), \"npx-cli.js\") : undefined,\n path.resolve(path.dirname(process.execPath), \"node_modules/npm/bin/npx-cli.js\"),\n path.resolve(path.dirname(process.execPath), \"../lib/node_modules/npm/bin/npx-cli.js\"),\n ].filter((candidate): candidate is string => Boolean(candidate));\n const npxCli = candidates.find((candidate) => existsSync(candidate));\n if (!npxCli) {\n throw new Error(\"Unable to locate npm's npx-cli.js for the official MCP conformance runner\");\n }\n return { command: process.execPath, args: [npxCli, ...args] };\n}\n\nexport function buildOfficialConformanceArgs(\n options: OfficialConformanceOptions,\n): string[] {\n const args = [\n \"--yes\",\n `@modelcontextprotocol/conformance@${OFFICIAL_CONFORMANCE_VERSION}`,\n \"server\",\n \"--url\",\n options.url,\n ];\n if (options.suite) args.push(\"--suite\", options.suite);\n if (options.scenario) args.push(\"--scenario\", options.scenario);\n if (options.expectedFailures) {\n args.push(\"--expected-failures\", options.expectedFailures);\n }\n if (options.outputDir) args.push(\"--output-dir\", options.outputDir);\n if (options.specVersion) args.push(\"--spec-version\", options.specVersion);\n if (options.verbose) args.push(\"--verbose\");\n return args;\n}\n\nexport async function runOfficialConformance(\n options: OfficialConformanceOptions,\n): Promise<OfficialConformanceResult> {\n const nodeMajor = Number.parseInt(process.versions.node.split(\".\")[0] ?? \"0\", 10);\n if (nodeMajor < 22) {\n throw new Error(\n `Official MCP conformance ${OFFICIAL_CONFORMANCE_VERSION} requires Node.js 22 or newer; current runtime is ${process.versions.node}`,\n );\n }\n const args = buildOfficialConformanceArgs(options);\n const invocation = npxInvocation(args);\n\n return await new Promise<OfficialConformanceResult>((resolve, reject) => {\n const child = spawn(invocation.command, invocation.args, {\n cwd: options.cwd,\n env: {\n ...process.env,\n PATH: [path.dirname(process.execPath), process.env.PATH]\n .filter(Boolean)\n .join(path.delimiter),\n },\n stdio: options.stdio === \"inherit\" ? \"inherit\" : \"pipe\",\n });\n let stdout = \"\";\n let stderr = \"\";\n child.stdout?.on(\"data\", (chunk) => {\n stdout += chunk.toString();\n });\n child.stderr?.on(\"data\", (chunk) => {\n stderr += chunk.toString();\n });\n child.once(\"error\", reject);\n child.once(\"close\", (code) => {\n resolve({ exitCode: code ?? 1, stdout, stderr });\n });\n });\n}\n","import {\n MCP_APP_EXTENSION_ID,\n type McpFnManifest,\n} from \"@mcpfn/core\";\n\nexport type McpFnServerFeature =\n | \"tools\"\n | \"resources\"\n | \"prompts\"\n | \"completions\"\n | \"tasks\"\n | \"logging\";\n\nexport interface McpFnHostProfile {\n id: string;\n name: string;\n protocolVersions: string[];\n serverFeatures: McpFnServerFeature[];\n clientFeatures?: {\n sampling?: boolean;\n elicitation?: Array<\"form\" | \"url\">;\n roots?: boolean;\n };\n extensions?: string[];\n}\n\nexport interface McpFnHostCompatibilityIssue {\n severity: \"incompatible\" | \"degraded\";\n code: string;\n path: string;\n message: string;\n}\n\nexport interface McpFnHostCompatibilityResult {\n status: \"compatible\" | \"degraded\" | \"incompatible\";\n compatible: boolean;\n issues: McpFnHostCompatibilityIssue[];\n}\n\nexport const MCPFN_HOST_PROFILES = {\n toolsOnly: {\n id: \"mcpfn/tools-only\",\n name: \"Tools-only MCP host\",\n protocolVersions: [\"2025-03-26\", \"2025-06-18\", \"2025-11-25\"],\n serverFeatures: [\"tools\"],\n },\n fullProtocol: {\n id: \"mcpfn/full-protocol\",\n name: \"Full protocol MCP host\",\n protocolVersions: [\"2025-03-26\", \"2025-06-18\", \"2025-11-25\"],\n serverFeatures: [\"tools\", \"resources\", \"prompts\", \"completions\", \"tasks\", \"logging\"],\n clientFeatures: { sampling: true, elicitation: [\"form\", \"url\"], roots: true },\n },\n mcpApps: {\n id: \"mcpfn/mcp-apps\",\n name: \"Full protocol host with MCP Apps\",\n protocolVersions: [\"2025-11-25\"],\n serverFeatures: [\"tools\", \"resources\", \"prompts\", \"completions\", \"tasks\", \"logging\"],\n clientFeatures: { sampling: true, elicitation: [\"form\", \"url\"], roots: true },\n extensions: [MCP_APP_EXTENSION_ID],\n },\n} as const satisfies Record<string, McpFnHostProfile>;\n\nexport function checkHostCompatibility(\n manifest: McpFnManifest,\n profile: McpFnHostProfile,\n): McpFnHostCompatibilityResult {\n const issues: McpFnHostCompatibilityIssue[] = [];\n if (\n manifest.protocolVersions?.length &&\n !manifest.protocolVersions.some((version) => profile.protocolVersions.includes(version))\n ) {\n issues.push({\n severity: \"incompatible\",\n code: \"protocol-version-mismatch\",\n path: \"protocolVersions\",\n message: `${profile.name} and ${manifest.server.name} have no protocol version in common`,\n });\n }\n\n const supportedServerFeatures = new Set(profile.serverFeatures);\n for (const feature of Object.keys(manifest.capabilities ?? {})) {\n if (\n feature === \"experimental\" ||\n supportedServerFeatures.has(feature as McpFnServerFeature)\n ) continue;\n issues.push({\n severity: \"degraded\",\n code: \"server-feature-unavailable\",\n path: `capabilities.${feature}`,\n message: `${profile.name} will not expose the server's ${feature} feature`,\n });\n }\n\n const required = manifest.clientRequirements;\n if (required?.sampling && !profile.clientFeatures?.sampling) {\n issues.push({\n severity: \"incompatible\",\n code: \"sampling-required\",\n path: \"clientRequirements.sampling\",\n message: `${manifest.server.name} requires client sampling`,\n });\n }\n if (required?.roots && !profile.clientFeatures?.roots) {\n issues.push({\n severity: \"incompatible\",\n code: \"roots-required\",\n path: \"clientRequirements.roots\",\n message: `${manifest.server.name} requires client roots`,\n });\n }\n for (const mode of required?.elicitation ?? []) {\n if (!profile.clientFeatures?.elicitation?.includes(mode)) {\n issues.push({\n severity: \"incompatible\",\n code: \"elicitation-required\",\n path: `clientRequirements.elicitation.${mode}`,\n message: `${manifest.server.name} requires ${mode} elicitation`,\n });\n }\n }\n\n const extensions = new Set(profile.extensions ?? []);\n for (const [extension, configuration] of Object.entries(manifest.extensions ?? {})) {\n if (extensions.has(extension)) continue;\n const requiredExtension =\n configuration && typeof configuration === \"object\" &&\n (configuration as Record<string, unknown>).required === true;\n issues.push({\n severity: requiredExtension ? \"incompatible\" : \"degraded\",\n code: \"extension-unavailable\",\n path: `extensions.${extension}`,\n message: `${profile.name} does not support ${extension}`,\n });\n }\n\n if (!extensions.has(MCP_APP_EXTENSION_ID)) {\n for (const tool of manifest.tools) {\n const ui = tool.metadata?.ui as { visibility?: string[] } | undefined;\n if (ui?.visibility?.length && !ui.visibility.includes(\"model\")) {\n issues.push({\n severity: \"incompatible\",\n code: \"app-only-tool-unavailable\",\n path: `tools.${tool.name}.metadata.ui.visibility`,\n message: `${tool.name} is app-only but ${profile.name} does not support MCP Apps`,\n });\n }\n }\n }\n\n issues.sort((left, right) => left.path.localeCompare(right.path) || left.code.localeCompare(right.code));\n const status = issues.some((issue) => issue.severity === \"incompatible\")\n ? \"incompatible\"\n : issues.length\n ? \"degraded\"\n : \"compatible\";\n return { status, compatible: status !== \"incompatible\", issues };\n}\n","import type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\n\nimport { McpFnAssertionError, assertStructuredTextParity, stableJson } from \"./assertions.js\";\nimport type { McpFnTestClient } from \"./client.js\";\n\nexport interface McpFnScenario {\n name: string;\n tool: string;\n arguments?: Record<string, unknown>;\n expect?: {\n isError?: boolean;\n structuredContent?: unknown;\n structuredTextParity?: boolean;\n };\n verify?(result: CallToolResult): void | Promise<void>;\n}\n\nexport interface McpFnScenarioResult {\n name: string;\n tool: string;\n status: \"passed\" | \"failed\";\n durationMs: number;\n error?: string;\n}\n\nexport async function runScenarios(\n client: McpFnTestClient<unknown>,\n scenarios: McpFnScenario[],\n): Promise<McpFnScenarioResult[]> {\n const results: McpFnScenarioResult[] = [];\n for (const scenario of scenarios) {\n const startedAt = performance.now();\n try {\n const result = await client.callTool(scenario.tool, scenario.arguments);\n if (result.isError && scenario.expect?.isError === undefined) {\n throw new McpFnAssertionError(\n \"Tool returned isError=true without an explicit expect.isError=true assertion\",\n );\n }\n if (\n scenario.expect?.isError !== undefined &&\n Boolean(result.isError) !== scenario.expect.isError\n ) {\n throw new McpFnAssertionError(\n `Expected isError=${scenario.expect.isError}, received ${Boolean(result.isError)}`,\n );\n }\n if (\n scenario.expect &&\n Object.prototype.hasOwnProperty.call(scenario.expect, \"structuredContent\") &&\n stableJson(result.structuredContent) !==\n stableJson(scenario.expect.structuredContent)\n ) {\n throw new McpFnAssertionError(\n `Structured result mismatch\\nexpected: ${stableJson(scenario.expect.structuredContent)}\\nactual: ${stableJson(result.structuredContent)}`,\n );\n }\n if (scenario.expect?.structuredTextParity) {\n assertStructuredTextParity(result);\n }\n await scenario.verify?.(result);\n results.push({\n name: scenario.name,\n tool: scenario.tool,\n status: \"passed\",\n durationMs: performance.now() - startedAt,\n });\n } catch (error) {\n results.push({\n name: scenario.name,\n tool: scenario.tool,\n status: \"failed\",\n durationMs: performance.now() - startedAt,\n error: error instanceof Error ? error.message : String(error),\n });\n }\n }\n return results;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACCA,yBAA4B;AAKrB,SAAS,WAAW,OAAwB;AACjD,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO,IAAI,MAAM,IAAI,UAAU,EAAE,KAAK,GAAG,CAAC;AACpE,MAAI,SAAS,OAAO,UAAU,UAAU;AACtC,WAAO,IAAI,OAAO,QAAQ,KAAgC,EACvD,OAAO,CAAC,CAAC,EAAE,KAAK,MAAM,UAAU,MAAS,EACzC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,MAAM,OAAO,QAAQ,KAAK,OAAO,QAAQ,IAAI,CAAC,EAClE,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,GAAG,KAAK,UAAU,GAAG,CAAC,IAAI,WAAW,KAAK,CAAC,EAAE,EACnE,KAAK,GAAG,CAAC;AAAA,EACd;AACA,SAAO,KAAK,UAAU,KAAK;AAC7B;AAEO,IAAM,sBAAN,cAAkC,MAAM;AAAA,EAC7C,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAOA,eAAsB,uBACpB,QACA,UACA,UAAyC,CAAC,GACzB;AACjB,QAAM,SAAS,MAAM,OAAO,UAAU;AACtC,QAAM,eAAe,IAAI,IAAI,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC;AACpE,QAAM,iBAAiB,IAAI,IAAI,SAAS,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC;AAC9E,QAAM,gBAAgB,CAAC,GACrB,QAAQ,qBAAqB,SAAS,MAAM,IAAI,CAAC,SAAS,KAAK,IAAI,CACpE,EAAE,KAAK;AACR,QAAM,uBAAuB,cAAc,OAAO,CAAC,SAAS,CAAC,eAAe,IAAI,IAAI,CAAC;AACrF,MAAI,qBAAqB,QAAQ;AAC/B,UAAM,IAAI;AAAA,MACR,wDAAwD,WAAW,oBAAoB,CAAC;AAAA,IAC1F;AAAA,EACF;AACA,QAAM,cAAc,OAAO,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,KAAK;AACzD,MAAI,WAAW,aAAa,MAAM,WAAW,WAAW,GAAG;AACzD,UAAM,IAAI;AAAA,MACR;AAAA,YAAsC,WAAW,aAAa,CAAC;AAAA,YAAe,WAAW,WAAW,CAAC;AAAA,IACvG;AAAA,EACF;AACA,aAAW,QAAQ,eAAe;AAChC,UAAM,WAAW,eAAe,IAAI,IAAI;AACxC,UAAM,OAAO,aAAa,IAAI,SAAS,IAAI;AAC3C,UAAM,qBAAqB;AAAA,MACzB,MAAM,SAAS;AAAA,MACf,aAAa,SAAS;AAAA,MACtB,aAAa,SAAS;AAAA,MACtB,cAAc,SAAS;AAAA,MACvB,aAAa,SAAS;AAAA,MACtB,WAAW,SAAS;AAAA,MACpB,OAAO,SAAS;AAAA,MAChB,OAAO,SAAS;AAAA,MAChB,OAAO,SAAS;AAAA,IAClB;AACA,UAAM,mBAAmB;AAAA,MACvB,MAAM,KAAK;AAAA,MACX,aAAa,KAAK;AAAA,MAClB,aAAa,KAAK;AAAA,MAClB,cAAc,KAAK;AAAA,MACnB,aAAa,KAAK;AAAA,MAClB,WAAW,KAAK;AAAA,MAChB,OAAO,KAAK;AAAA,MACZ,OAAO,KAAK;AAAA,MACZ,OAAO,KAAK;AAAA,IACd;AACA,QAAI,WAAW,kBAAkB,MAAM,WAAW,gBAAgB,GAAG;AACnE,YAAM,IAAI;AAAA,QACR,yBAAyB,SAAS,IAAI;AAAA,YAAe,WAAW,kBAAkB,CAAC;AAAA,YAAe,WAAW,gBAAgB,CAAC;AAAA,MAChI;AAAA,IACF;AAAA,EACF;AAEA,QAAM,qBAAqB,OAAO,OAAO,sBAAsB,KAAK,CAAC;AACrE,MAAI,WAAW,SAAS,gBAAgB,CAAC,CAAC,MAAM,WAAW,kBAAkB,GAAG;AAC9E,UAAM,IAAI;AAAA,MACR;AAAA,YAAkC,WAAW,SAAS,gBAAgB,CAAC,CAAC,CAAC;AAAA,YAAe,WAAW,kBAAkB,CAAC;AAAA,IACxH;AAAA,EACF;AAEA,QAAM,kBAAkB,mBAAmB,YACvC,MAAM,OAAO,cAAc,IAC3B,CAAC;AACL,QAAM,sBAAsB,gBAAgB,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,OAAO;AAAA,IAC3E,GAAG;AAAA,IACH,UAAU;AAAA,EACZ,EAAE;AACF,QAAM,qBAAqB,IAAI;AAAA,KAC5B,SAAS,aAAa,CAAC,GAAG,IAAI,CAAC,aAAa,SAAS,GAAG;AAAA,EAC3D;AACA,QAAM,qBAAqB,SAAS,qBAAqB,CAAC,GAAG;AAAA,IAC3D,CAAC,aAAa,IAAI,+BAAY,SAAS,WAAW;AAAA,EACpD;AACA,QAAM,4BAA4B,oBAAoB;AAAA,IACpD,CAAC,aACC,mBAAmB,IAAI,SAAS,GAAG,KACnC,CAAC,kBAAkB,KAAK,CAAC,aAAa,SAAS,MAAM,SAAS,GAAG,CAAC;AAAA,EACtE;AACA,QAAM,qBAAqB,SAAS,aAAa,CAAC,GAAG;AAAA,IACnD,CAAC,EAAE,cAAc,eAAe,GAAG,SAAS,MAAM;AAAA,EACpD;AACA,MAAI,WAAW,iBAAiB,MAAM,WAAW,yBAAyB,GAAG;AAC3E,UAAM,IAAI;AAAA,MACR;AAAA,YAA0C,WAAW,iBAAiB,CAAC;AAAA,YAAe,WAAW,yBAAyB,CAAC;AAAA,IAC7H;AAAA,EACF;AAEA,QAAM,kBAAkB,mBAAmB,YACvC,MAAM,OAAO,sBAAsB,IACnC,CAAC;AACL,QAAM,sBAAsB,gBAAgB,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,OAAO;AAAA,IAC3E,GAAG;AAAA,IACH,UAAU;AAAA,EACZ,EAAE;AACF,QAAM,qBAAqB,SAAS,qBAAqB,CAAC,GAAG;AAAA,IAC3D,CAAC,EAAE,cAAc,eAAe,GAAG,SAAS,MAAM;AAAA,EACpD;AACA,MAAI,WAAW,iBAAiB,MAAM,WAAW,mBAAmB,GAAG;AACrE,UAAM,IAAI;AAAA,MACR;AAAA,YAAmD,WAAW,iBAAiB,CAAC;AAAA,YAAe,WAAW,mBAAmB,CAAC;AAAA,IAChI;AAAA,EACF;AAEA,aAAW,YAAY,qBAAqB;AAC1C,UAAM,YAAY,SAAS,aAAa,CAAC,GAAG;AAAA,MAC1C,CAAC,cAAc,UAAU,QAAQ,SAAS;AAAA,IAC5C,MAAM,SAAS,qBAAqB,CAAC,GAAG;AAAA,MACtC,CAAC,cAAc,IAAI,+BAAY,UAAU,WAAW,EAAE,MAAM,SAAS,GAAG;AAAA,IAC1E;AACA,UAAM,eAAe,UAAU,iBAAiB;AAChD,QAAI,cAAc;AAChB,UAAI;AACF,cAAM,OAAO,kBAAkB,SAAS,GAAG;AAC3C,cAAM,OAAO,oBAAoB,SAAS,GAAG;AAAA,MAC/C,SAAS,OAAO;AACd,cAAM,IAAI;AAAA,UACR,sCAAsC,SAAS,GAAG,oDAAoD,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,QAC9J;AAAA,MACF;AACA;AAAA,IACF;AACA,QAAI,WAAW;AACf,QAAI;AACF,YAAM,OAAO,kBAAkB,SAAS,GAAG;AAC3C,iBAAW;AACX,YAAM,OAAO,oBAAoB,SAAS,GAAG,EAAE,MAAM,MAAM,MAAS;AAAA,IACtE,QAAQ;AAAA,IAER;AACA,QAAI,UAAU;AACZ,YAAM,IAAI;AAAA,QACR,sCAAsC,SAAS,GAAG;AAAA,MACpD;AAAA,IACF;AAAA,EACF;AAEA,QAAM,gBAAgB,mBAAmB,UACrC,MAAM,OAAO,YAAY,IACzB,CAAC;AACL,QAAM,oBAAoB,cAAc,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,OAAO;AAAA,IACrE,GAAG;AAAA,IACH,UAAU;AAAA,EACZ,EAAE;AACF,QAAM,mBAAmB,SAAS,WAAW,CAAC,GAAG,IAAI,CAAC,EAAE,iBAAiB,SAAS,GAAG,OAAO,MAAM,MAAM;AACxG,MAAI,WAAW,eAAe,MAAM,WAAW,iBAAiB,GAAG;AACjE,UAAM,IAAI;AAAA,MACR;AAAA,YAAwC,WAAW,eAAe,CAAC;AAAA,YAAe,WAAW,iBAAiB,CAAC;AAAA,IACjH;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,2BAA2B,QAGlC;AACP,MAAI,CAAC,OAAO,mBAAmB;AAC7B,UAAM,IAAI,oBAAoB,sCAAsC;AAAA,EACtE;AACA,QAAM,QAAQ,OAAO,WAAW,CAAC,GAAG;AAAA,IAClC,CAAC,UACC,CAAC,CAAC,SACF,OAAO,UAAU,YAChB,MAA6B,SAAS,UACvC,OAAQ,MAA6B,SAAS;AAAA,EAClD,GAAG;AACH,MAAI,CAAC,MAAM;AACT,UAAM,IAAI,oBAAoB,iCAAiC;AAAA,EACjE;AACA,MAAI;AACJ,MAAI;AACF,aAAS,KAAK,MAAM,IAAI;AAAA,EAC1B,QAAQ;AACN,UAAM,IAAI,oBAAoB,+BAA+B;AAAA,EAC/D;AACA,MAAI,WAAW,MAAM,MAAM,WAAW,OAAO,iBAAiB,GAAG;AAC/D,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACF;;;AClIO,IAAM,0BAAN,cAAsC,MAAM;AAAA,EACjD,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAEA,SAAS,eACP,UACA,UACA,MACM;AACN,QAAM,WAAW,MAAM,QAAQ,QAAQ,IAAI,WAAW,CAAC,QAAQ;AAC/D,MAAI,CAAC,SAAS,SAAS,SAAS,MAAM,GAAG;AACvC,UAAM,IAAI;AAAA,MACR,GAAG,IAAI,kBAAkB,SAAS,KAAK,MAAM,CAAC,cAAc,SAAS,MAAM;AAAA,IAC7E;AAAA,EACF;AACF;AAEO,SAAS,qBACd,QACkC;AAClC,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,UAAU,CAAC,GAAG,OAAO,SAAS,wCAAwC,CAAC;AAC7E,QAAM,gBAAgB,QAAQ,UAAU,CAAC,UAAU,MAAM,CAAC,EAAE,YAAY,MAAM,QAAQ;AACtF,MAAI,gBAAgB,EAAG,QAAO;AAC9B,QAAM,QAAQ,QAAQ,aAAa;AACnC,QAAM,SAAS,MAAM,SAAS,KAAK,MAAM,CAAC,EAAE;AAC5C,QAAM,MAAM,QAAQ,gBAAgB,CAAC,GAAG,SAAS,OAAO;AACxD,QAAM,aAAqC,CAAC;AAC5C,QAAM,SAAS,OAAO,MAAM,OAAO,GAAG;AACtC,QAAM,UAAU;AAChB,aAAW,SAAS,OAAO,SAAS,OAAO,GAAG;AAC5C,UAAM,SAAS,MAAM,CAAC,GAAG,QAAQ,cAAc,IAAI;AACnD,eAAW,MAAM,CAAC,CAAC,IAAI,UAAU,MAAM,CAAC,KAAK;AAAA,EAC/C;AACA,SAAO,EAAE,QAAQ,MAAM,CAAC,GAAG,WAAW;AACxC;AAEO,SAAS,8BACd,UACA,qBACsB;AACtB,QAAM,YAAY,qBAAqB,SAAS,QAAQ,IAAI,kBAAkB,CAAC;AAC/E,MAAI,CAAC,aAAa,UAAU,OAAO,YAAY,MAAM,UAAU;AAC7D,UAAM,IAAI,wBAAwB,8CAA8C;AAAA,EAClF;AACA,QAAM,cAAc,UAAU,WAAW;AACzC,MAAI,CAAC,aAAa;AAChB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,MAAI;AACF,UAAM,SAAS,IAAI,IAAI,WAAW;AAClC,QAAI,CAAC,OAAO,YAAY,CAAC,OAAO,KAAM,OAAM,IAAI,MAAM,cAAc;AAAA,EACtE,QAAQ;AACN,UAAM,IAAI;AAAA,MACR,0DAA0D,WAAW;AAAA,IACvE;AAAA,EACF;AACA,MAAI,uBAAuB,gBAAgB,qBAAqB;AAC9D,UAAM,IAAI;AAAA,MACR,8BAA8B,mBAAmB,cAAc,WAAW;AAAA,IAC5E;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,iBACd,OACA,OAAgC,SACX;AACrB,SAAO;AAAA,IACL;AAAA,IACA,SAAS,EAAE,eAAe,UAAU,KAAK,GAAG;AAAA,EAC9C;AACF;AAEO,SAAS,iBACd,QACA,UAAoD,CAAC,GAChC;AACrB,QAAM,aAAa,QAAQ,cAAc;AACzC,QAAM,QAAQ,QAAQ,WAAW,KAC7B,SACA,GAAG,QAAQ,UAAU,QAAQ,IAAI,MAAM;AAC3C,SAAO,EAAE,MAAM,WAAW,SAAS,EAAE,CAAC,UAAU,GAAG,MAAM,EAAE;AAC7D;AAEA,SAAS,eAAe,SAA8C;AACpE,SAAO,IAAI,QAAQ,QAAQ,4BAA4B;AAAA,IACrD,eAAe,wBAAwB,QAAQ,IAAI;AAAA,EACrD,CAAC;AACH;AAEA,eAAe,OACb,SACA,UACA,SACA,UACkC;AAClC,MAAI;AACJ,MAAI;AACF,iBAAa,MAAM,QAAQ;AAC3B,UAAM,UAAU,aACZ,IAAI,QAAQ,WAAW,OAAO,IAC9B,SAAS,SAAS,uBAChB,eAAe,OAAO,IACtB,IAAI,QAAQ;AAClB,UAAM,WAAW,MAAM,QAAQ,OAAO,QAAQ,SAAS,QAAQ;AAC/D,mBAAe,UAAU,UAAU,SAAS,IAAI;AAChD,QACE,QAAQ,SAAS,WACjB,SAAS,SAAS,oBAClB;AACA;AAAA,QACE;AAAA,QACA,QAAQ;AAAA,MACV;AAAA,IACF;AACA,QAAI,SAAS,SAAS,sBAAsB,YAAY;AACtD,YAAM,QAAQ,8BAA8B,SAAS,MAAM,GAAG,UAAU;AAAA,IAC1E;AACA,WAAO;AAAA,MACL,MAAM,SAAS;AAAA,MACf,QAAQ;AAAA,MACR,gBAAgB,SAAS;AAAA,IAC3B;AAAA,EACF,SAAS,OAAO;AACd,WAAO;AAAA,MACL,MAAM,SAAS;AAAA,MACf,QAAQ;AAAA,MACR,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,IAC9D;AAAA,EACF,UAAE;AACA,UAAM,YAAY,UAAU;AAAA,EAC9B;AACF;AAGA,eAAsB,uBACpB,SACoC;AACpC,QAAM,QAAQ,CAAC,YAAiD,CAAC,MAC/D,QAAQ,SAAS,MAAM;AAAA,IACrB,MAAM,QAAQ;AAAA,IACd,QAAQ,QAAQ;AAAA,IAChB,UAAU,QAAQ;AAAA,IAClB,GAAG;AAAA,EACL,CAAC;AACH,QAAM,UAAqC,CAAC;AAC5C,UAAQ,KAAK,MAAM;AAAA,IACjB;AAAA,IACA,EAAE,MAAM,sBAAsB,MAAM,QAAQ,KAAK;AAAA,IACjD,YAAY;AAAA,IACZ;AAAA,EACF,CAAC;AACD,UAAQ,KAAK,MAAM;AAAA,IACjB;AAAA,IACA,EAAE,MAAM,sBAAsB,MAAM,QAAQ,KAAK;AAAA,IACjD,YAAY;AAAA,IACZ;AAAA,EACF,CAAC;AACD,UAAQ,KAAK,MAAM;AAAA,IACjB;AAAA,IACA,EAAE,MAAM,oBAAoB,MAAM,QAAQ,KAAK;AAAA,IAC/C,MAAM,MAAM;AAAA,IACZ,QAAQ,iCAAiC,CAAC,KAAK,KAAK,KAAK,GAAG;AAAA,EAC9D,CAAC;AAED,QAAM,eAAe,QAAQ,SAAS,gBAAgB,CAAC;AACvD,MAAI,aAAa,UAAU,QAAQ,gBAAgB,QAAQ;AACzD,YAAQ,KAAK,MAAM;AAAA,MACjB;AAAA,MACA,EAAE,MAAM,sBAAsB,MAAM,QAAQ,KAAK;AAAA,MACjD,MAAM,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;AAAA,MAC1B;AAAA,IACF,CAAC;AAAA,EACH;AACA,MAAI,aAAa,YAAY;AAC3B,YAAQ,KAAK,MAAM;AAAA,MACjB;AAAA,MACA,EAAE,MAAM,sBAAsB,MAAM,QAAQ,KAAK;AAAA,MACjD,MAAM,MAAM,EAAE,kBAAkB,IAAI,CAAC;AAAA,MACrC;AAAA,IACF,CAAC;AAAA,EACH;AACA,MAAI,aAAa,mBAAmB,QAAQ,UAAU;AACpD,YAAQ,KAAK,MAAM;AAAA,MACjB;AAAA,MACA,EAAE,MAAM,oBAAoB,MAAM,QAAQ,KAAK;AAAA,MAC/C,MAAM,MAAM,EAAE,UAAU,OAAU,CAAC;AAAA,MACnC;AAAA,IACF,CAAC;AAAA,EACH;AACA,MAAI,aAAa,mBAAmB,QAAQ,eAAe;AACzD,YAAQ,KAAK,MAAM;AAAA,MACjB;AAAA,MACA,EAAE,MAAM,kBAAkB,MAAM,QAAQ,KAAK;AAAA,MAC7C,MAAM,MAAM,EAAE,UAAU,QAAQ,cAAc,CAAC;AAAA,MAC/C;AAAA,IACF,CAAC;AAAA,EACH;AACA,MAAI,aAAa,cAAc,QAAQ,SAAS,QAAQ;AACtD,YAAQ,KAAK,MAAM;AAAA,MACjB;AAAA,MACA,EAAE,MAAM,sBAAsB,MAAM,QAAQ,KAAK;AAAA,MACjD,YAAY;AACV,cAAM,aAAa,MAAM,MAAM;AAC/B,cAAM,QAAQ,SAAS,SAAS,UAAU;AAC1C,eAAO;AAAA,MACT;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AACA,SAAO;AACT;AAEA,eAAsB,0BACpB,SACoC;AACpC,QAAM,UAAU,MAAM,uBAAuB,OAAO;AACpD,QAAM,WAAW,QAAQ,OAAO,CAAC,WAAW,OAAO,WAAW,QAAQ;AACtE,MAAI,SAAS,QAAQ;AACnB,UAAM,IAAI;AAAA,MACR,SAAS,IAAI,CAAC,YAAY,GAAG,QAAQ,IAAI,KAAK,QAAQ,KAAK,EAAE,EAAE,KAAK,IAAI;AAAA,IAC1E;AAAA,EACF;AACA,SAAO;AACT;AASO,SAAS,sBACd,SACiB;AACjB,QAAM,sBAAsB,QAAQ,SAAS,WAAW;AACxD,MAAI,CAAC,qBAAqB;AACxB,UAAM,IAAI,MAAM,oCAAoC;AAAA,EACtD;AACA,SAAO;AAAA,IACL,MAAM,QAAQ,aAAa,UAAU;AACnC,YAAM,aAAa,OAAO,QAAQ,gBAAgB,aAC9C,QAAQ,YAAY,QAAQ,IAC5B,QAAQ,eAAe,CAAC;AAC5B,YAAM,UAAU,IAAI,QAAQ,WAAW,OAAO;AAC9C,cAAQ,IAAI,UAAU,qCAAqC;AAC3D,cAAQ,IAAI,gBAAgB,kBAAkB;AAC9C,kBAAY,QAAQ,CAAC,OAAO,SAAS,QAAQ,IAAI,MAAM,KAAK,CAAC;AAC7D,aAAO,oBAAoB,QAAQ,KAAK;AAAA,QACtC,QAAQ;AAAA,QACR,MAAM,KAAK,UAAU;AAAA,UACnB,SAAS;AAAA,UACT,IAAI,cAAc,SAAS,IAAI;AAAA,UAC/B,QAAQ;AAAA,UACR,QAAQ;AAAA,YACN,iBAAiB;AAAA,YACjB,cAAc,CAAC;AAAA,YACf,YAAY,EAAE,MAAM,mBAAmB,SAAS,QAAQ;AAAA,UAC1D;AAAA,QACF,CAAC;AAAA,QACD,GAAG;AAAA,QACH;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;AAEO,IAAM,+BAA+B;AAAA,EAC1C,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,SAAS;AACX;AA0BO,SAAS,iCACd,SAC0B;AAC1B,SAAO;AAAA,IACL,GAAG,QAAQ;AAAA,IACX,WAAW,IAAI,IAAI,QAAQ,QAAQ,EAAE,SAAS;AAAA,IAC9C,aAAa,QAAQ,cAAc;AAAA,IACnC,eAAe,CAAC,GAAG,IAAI,IAAI,QAAQ,aAAa,IAAI,CAAC,QAAQ,IAAI,IAAI,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;AAAA,IACtF,gBAAgB,CAAC,MAAM;AAAA,IACvB,aAAa;AAAA,MACX;AAAA,MACA;AAAA,MACA,GAAG,IAAI,IAAI,QAAQ,mBAAmB,CAAC,CAAC;AAAA,IAC1C;AAAA,IACA,4BAA4B;AAAA,EAC9B;AACF;AAEO,SAAS,kCACd,SACA,cAAc,IAAI,IAAI,aAAa,OAAO,EAAE,SAAS,GACnB;AAClC,QAAM,OAAO,IAAI,IAAI,OAAO;AAC5B,QAAM,UAAU,CAAC,MAAc,kBAA4B,CAAC,MAC1D,iCAAiC;AAAA,IAC/B,UAAU,IAAI,IAAI,oBAAoB,IAAI,IAAI,IAAI,EAAE,SAAS;AAAA,IAC7D,cAAc,CAAC,WAAW;AAAA,IAC1B,YAAY,SAAS,IAAI;AAAA,IACzB;AAAA,EACF,CAAC;AACH,SAAO;AAAA,IACL,OAAO,QAAQ,OAAO;AAAA,IACtB,oBAAoB,QAAQ,wBAAwB,CAAC,6BAA6B,SAAS,CAAC;AAAA,IAC5F,qBAAqB,QAAQ,yBAAyB,CAAC,6BAA6B,UAAU,CAAC;AAAA,IAC/F,kBAAkB,QAAQ,qBAAqB,CAAC,6BAA6B,OAAO,CAAC;AAAA,EACvF;AACF;AAMO,SAAS,sCACd,UACA,kBAC0B;AAC1B,MAAI,oBAAoB,SAAS,cAAc,IAAI,IAAI,gBAAgB,EAAE,SAAS,GAAG;AACnF,UAAM,IAAI,wBAAwB,iEAAiE;AAAA,EACrG;AACA,MAAI,CAAC,SAAS,eAAe,SAAS,MAAM,GAAG;AAC7C,UAAM,IAAI,wBAAwB,2DAA2D;AAAA,EAC/F;AACA,MAAI,CAAC,SAAS,YAAY,SAAS,oBAAoB,GAAG;AACxD,UAAM,IAAI,wBAAwB,2DAA2D;AAAA,EAC/F;AACA,MAAI,CAAC,SAAS,cAAc,QAAQ;AAClC,UAAM,IAAI,wBAAwB,8DAA8D;AAAA,EAClG;AACA,SAAO;AACT;;;AC9bA,yBAAoD;AACpD,uBAAwE;AAoExE,SAAS,UAAU,OAAuB;AACxC,SAAO,MAAM,SAAS,WAAW;AACnC;AAEO,SAAS,iBAAgC;AAC9C,QAAM,WAAW,cAAU,gCAAY,EAAE,CAAC;AAC1C,SAAO;AAAA,IACL;AAAA,IACA,eAAW,+BAAW,QAAQ,EAAE,OAAO,QAAQ,EAAE,OAAO,WAAW;AAAA,IACnE,QAAQ;AAAA,EACV;AACF;AAEA,SAAS,aAAa,OAA4C;AAChE,SAAO,CAAC,GAAG,IAAI,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE,OAAO,OAAO,CAAC,CAAC,EAAE,KAAK;AACvE;AAEA,SAAS,KAAK,QAAgB,MAAyB;AACrD,SAAO,SAAS,KAAK,MAAM;AAAA,IACzB;AAAA,IACA,SAAS,EAAE,iBAAiB,WAAW;AAAA,EACzC,CAAC;AACH;AAEA,SAAS,WAAW,QAAgB,OAAe,aAA+B;AAChF,SAAO,KAAK,QAAQ,EAAE,OAAO,mBAAmB,YAAY,CAAC;AAC/D;AAEA,SAAS,WAAW,OAAuB;AACzC,SAAO,MACJ,WAAW,KAAK,OAAO,EACvB,WAAW,KAAK,QAAQ,EACxB,WAAW,KAAK,MAAM,EACtB,WAAW,KAAK,MAAM;AAC3B;AAEA,SAAS,UAAU,MAAuB,MAAkC;AAC1E,QAAM,QAAQ,KAAK,IAAI,IAAI;AAC3B,SAAO,UAAU,QAAQ,UAAU,KAAK,SAAY;AACtD;AAEO,IAAM,oCAAN,MAAwC;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEQ,QAAQ,oBAAI,IAAqC;AAAA,EACjD,eAAe,oBAAI,IAA+B;AAAA,EAClD,gBAAgB,oBAAI,IAAgC;AAAA,EACpD,YAAkC,CAAC;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,YAAY,SAAsC;AAChD,SAAK,SAAS,IAAI,IAAI,QAAQ,MAAM;AACpC,SAAK,OAAO,WAAW,KAAK,OAAO,SAAS,QAAQ,QAAQ,GAAG;AAC/D,SAAK,WAAW,QAAQ,YAAY;AACpC,SAAK,eAAe,QAAQ,cAAc,IAAI,CAAC,QAAQ,IAAI,IAAI,GAAG,EAAE,SAAS,CAAC,KAAK;AAAA,MACjF,IAAI,IAAI,YAAY,KAAK,MAAM,EAAE,SAAS;AAAA,IAC5C;AACA,SAAK,kBAAkB,CAAC,GAAG,IAAI,IAAI,QAAQ,mBAAmB,CAAC,YAAY,WAAW,CAAC,CAAC,EAAE,KAAK;AAC/F,SAAK,QAAQ,QAAQ,SAAS,KAAK;AACnC,SAAK,6BAA6B,QAAQ,8BAA8B;AACxE,SAAK,mCAAmC,QAAQ,oCAAoC;AACpF,SAAK,8BAA8B,QAAQ,+BAA+B;AAC1E,SAAK,iBAAiB;AAAA,MACpB,KAAK;AAAA,MACL,KAAK,aAAa,CAAC;AAAA,IACrB;AAAA,EACF;AAAA,EAEA,IAAI,cAAsB;AACxB,WAAO,IAAI,IAAI,0CAA0C,KAAK,MAAM,EAAE,SAAS;AAAA,EACjF;AAAA,EAEA,IAAI,wBAAgC;AAClC,WAAO,IAAI,IAAI,aAAa,KAAK,MAAM,EAAE,SAAS;AAAA,EACpD;AAAA,EAEA,IAAI,gBAAwB;AAC1B,WAAO,IAAI,IAAI,SAAS,KAAK,MAAM,EAAE,SAAS;AAAA,EAChD;AAAA,EAEA,IAAI,qBAA6B;AAC/B,WAAO,IAAI,IAAI,UAAU,KAAK,MAAM,EAAE,SAAS;AAAA,EACjD;AAAA,EAEA,IAAI,cAAsB;AACxB,WAAO,KAAK,aAAa,CAAC;AAAA,EAC5B;AAAA,EAEA,kBACE,SACQ;AACR,WAAO,KAAK,eAAe,OAAO,EAAE;AAAA,EACtC;AAAA,EAEA,iBAAiB,OAQN;AACT,UAAM,MAAM,IAAI,IAAI,KAAK,qBAAqB;AAC9C,QAAI,aAAa,IAAI,iBAAiB,MAAM;AAC5C,QAAI,aAAa,IAAI,aAAa,MAAM,YAAY,KAAK,QAAQ;AACjE,QAAI,aAAa,IAAI,gBAAgB,MAAM,eAAe,KAAK,WAAW;AAC1E,QAAI,aAAa,IAAI,kBAAkB,MAAM,aAAa;AAC1D,QAAI,aAAa,IAAI,yBAAyB,MAAM;AACpD,QAAI,aAAa,IAAI,UAAU,MAAM,UAAU,CAAC,UAAU,GAAG,KAAK,GAAG,CAAC;AACtE,QAAI,MAAM,MAAO,KAAI,aAAa,IAAI,SAAS,MAAM,KAAK;AAC1D,QAAI,MAAM,SAAU,KAAI,aAAa,IAAI,YAAY,MAAM,QAAQ;AACnE,eAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ,MAAM,mBAAmB,CAAC,CAAC,GAAG;AACvE,UAAI,aAAa,IAAI,MAAM,KAAK;AAAA,IAClC;AACA,WAAO,IAAI,SAAS;AAAA,EACtB;AAAA,EAEA,iBAAiD;AAC/C,WAAO,KAAK,UAAU,GAAG,EAAE;AAAA,EAC7B;AAAA,EAEA,kBAAkB,OAAqB;AACrC,UAAM,SAAS,KAAK,aAAa,IAAI,KAAK;AAC1C,QAAI,OAAQ,QAAO,YAAY,KAAK,WAAW,IAAI;AAAA,EACrD;AAAA,EAEA,YAAY,OAAqB;AAC/B,UAAM,SAAS,KAAK,aAAa,IAAI,KAAK;AAC1C,QAAI,OAAQ,QAAO,UAAU;AAC7B,UAAM,UAAU,KAAK,cAAc,IAAI,KAAK;AAC5C,QAAI,QAAS,SAAQ,UAAU;AAAA,EACjC;AAAA,EAEA,MAAM,kBAAkB,OAAkC;AACxD,UAAM,SAAS,KAAK,aAAa,IAAI,KAAK;AAC1C,QAAI,CAAC,UAAU,OAAO,WAAW,OAAO,aAAa,KAAK,WAAW,GAAG;AACtE,YAAM,IAAI,MAAM,sBAAsB;AAAA,IACxC;AACA,WAAO;AAAA,MACL;AAAA,MACA,UAAU,OAAO;AAAA,MACjB,QAAQ,OAAO;AAAA,MACf,WAAW,OAAO;AAAA,MAClB,GAAI,OAAO,WAAW,EAAE,UAAU,IAAI,IAAI,OAAO,QAAQ,EAAE,IAAI,CAAC;AAAA,IAClE;AAAA,EACF;AAAA,EAEA,MAAM,OAAO,SAAqC;AAChD,UAAM,MAAM,IAAI,IAAI,QAAQ,GAAG;AAC/B,UAAMA,QAAO,IAAI,SAAS,QAAQ,KAAK,OAAO,SAAS,QAAQ,OAAO,EAAE,GAAG,EAAE,KAAK;AAClF,QAAI,QAAQ,WAAW,SAASA,UAAS,2CAA2C;AAClF,aAAO,KAAK,KAAK;AAAA,QACf,QAAQ,KAAK,OAAO,SAAS;AAAA,QAC7B,wBAAwB,KAAK;AAAA,QAC7B,gBAAgB,KAAK;AAAA,QACrB,qBAAqB,KAAK;AAAA,QAC1B,0BAA0B,CAAC,MAAM;AAAA,QACjC,uBAAuB,CAAC,sBAAsB,eAAe;AAAA,QAC7D,kCAAkC,CAAC,MAAM;AAAA,QACzC,uCAAuC,CAAC,MAAM;AAAA,QAC9C,kBAAkB,KAAK;AAAA,MACzB,CAAC;AAAA,IACH;AAEA,QAAI,QAAQ,WAAW,SAASA,MAAK,WAAW,mBAAmB,GAAG;AACpE,YAAM,WAAW,OAAO,OAAO,KAAK,cAAc,EAC/C,KAAK,CAAC,cAAc,IAAI,IAAI,UAAU,SAAS,EAAE,aAAa,IAAI,QAAQ;AAC7E,aAAO,WAAW,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,OAAO,YAAY,CAAC;AAAA,IAC1E;AAEA,QAAI,QAAQ,WAAW,SAASA,UAAS,cAAc;AACrD,aAAO,KAAK,UAAU,GAAG;AAAA,IAC3B;AACA,QAAI,QAAQ,WAAW,UAAUA,UAAS,UAAU;AAClD,aAAO,KAAK,MAAM,MAAM,QAAQ,KAAK,CAAC;AAAA,IACxC;AACA,QAAI,QAAQ,WAAW,UAAUA,UAAS,WAAW;AACnD,aAAO,KAAK,OAAO,MAAM,QAAQ,KAAK,CAAC;AAAA,IACzC;AACA,QAAI,QAAQ,WAAW,SAASA,UAAS,aAAa;AACpD,YAAM,aAAa,OAAO,YAAY,IAAI,YAAY;AACtD,WAAK,UAAU,KAAK,EAAE,KAAK,IAAI,SAAS,GAAG,WAAW,CAAC;AACvD,aAAO,IAAI;AAAA,QACT,yEAAyE,WAAW,KAAK,UAAU,YAAY,MAAM,CAAC,CAAC,CAAC;AAAA,QACxH,EAAE,SAAS,EAAE,gBAAgB,2BAA2B,EAAE;AAAA,MAC5D;AAAA,IACF;AACA,WAAO,KAAK,KAAK,EAAE,OAAO,YAAY,CAAC;AAAA,EACzC;AAAA,EAEQ,aAAqB;AAC3B,WAAO,KAAK,MAAM,KAAK,MAAM,IAAI,GAAK;AAAA,EACxC;AAAA,EAEQ,cAAc,UAA4E;AAChG,QAAI,aAAa,KAAK,UAAU;AAC9B,aAAO,EAAE,UAAU,cAAc,KAAK,aAAa;AAAA,IACrD;AACA,UAAM,WAAW,OAAO,OAAO,KAAK,cAAc,EAC/C,KAAK,CAAC,cAAc,UAAU,cAAc,QAAQ;AACvD,QAAI,CAAC,SAAU,QAAO;AACtB,0CAAsC,UAAU,QAAQ;AACxD,WAAO,EAAE,UAAU,cAAc,SAAS,cAAc;AAAA,EAC1D;AAAA,EAEQ,UAAU,KAAoB;AACpC,UAAM,WAAW,IAAI,aAAa,IAAI,WAAW,KAAK;AACtD,UAAM,cAAc,IAAI,aAAa,IAAI,cAAc,KAAK;AAC5D,UAAM,SAAS,KAAK,cAAc,QAAQ;AAC1C,QAAI,CAAC,OAAQ,QAAO,WAAW,KAAK,kBAAkB,sBAAsB;AAC5E,QAAI,CAAC,OAAO,aAAa,SAAS,WAAW,GAAG;AAC9C,aAAO,WAAW,KAAK,mBAAmB,gCAAgC;AAAA,IAC5E;AACA,QAAI,IAAI,aAAa,IAAI,eAAe,MAAM,QAAQ;AACpD,aAAO,KAAK,sBAAsB,KAAK,aAAa,2BAA2B;AAAA,IACjF;AACA,UAAM,gBAAgB,IAAI,aAAa,IAAI,gBAAgB;AAC3D,QAAI,CAAC,iBAAiB,IAAI,aAAa,IAAI,uBAAuB,MAAM,QAAQ;AAC9E,aAAO,KAAK,sBAAsB,KAAK,aAAa,mBAAmB,uBAAuB;AAAA,IAChG;AACA,UAAM,kBAAkB,aAAa,IAAI,aAAa,IAAI,OAAO,CAAC;AAClE,QAAI,gBAAgB,KAAK,CAAC,UAAU,CAAC,KAAK,gBAAgB,SAAS,KAAK,CAAC,GAAG;AAC1E,aAAO,KAAK,sBAAsB,KAAK,aAAa,eAAe;AAAA,IACrE;AACA,UAAM,WAAW,IAAI,aAAa,IAAI,UAAU;AAChD,QAAI,CAAC,UAAU;AACb,YAAM,SAAS,CAAC,GAAG,IAAI,YAAY,EAChC,OAAO,CAAC,CAAC,IAAI,MAAM,SAAS,UAAU,EACtC,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,8BAA8B,WAAW,IAAI,CAAC,YAAY,WAAW,KAAK,CAAC,IAAI,EACtG,KAAK,EAAE;AACV,aAAO,IAAI;AAAA,QACT,oEAAoE,WAAW,QAAQ,CAAC,kCAAkC,WAAW,KAAK,qBAAqB,CAAC,KAAK,MAAM;AAAA,QAC3K,EAAE,SAAS,EAAE,gBAAgB,4BAA4B,iBAAiB,WAAW,EAAE;AAAA,MACzF;AAAA,IACF;AACA,QAAI,aAAa,QAAQ;AACvB,aAAO,KAAK,sBAAsB,KAAK,aAAa,eAAe;AAAA,IACrE;AACA,QAAI,aAAa,WAAW;AAC1B,aAAO,WAAW,KAAK,mBAAmB,gCAAgC;AAAA,IAC5E;AACA,UAAM,OAAO,kBAAc,+BAAW,CAAC;AACvC,SAAK,MAAM,IAAI,MAAM;AAAA,MACnB;AAAA,MACA;AAAA,MACA;AAAA,MACA,QAAQ;AAAA,MACR,UAAU,IAAI,aAAa,IAAI,UAAU,KAAK;AAAA,MAC9C,WAAW,KAAK,WAAW,IAAI,KAAK;AAAA,MACpC,MAAM;AAAA,IACR,CAAC;AACD,UAAM,WAAW,IAAI,IAAI,WAAW;AACpC,aAAS,aAAa,IAAI,QAAQ,IAAI;AACtC,UAAM,QAAQ,IAAI,aAAa,IAAI,OAAO;AAC1C,QAAI,MAAO,UAAS,aAAa,IAAI,SAAS,KAAK;AACnD,WAAO,SAAS,SAAS,UAAU,GAAG;AAAA,EACxC;AAAA,EAEQ,sBACN,YACA,aACA,OACA,aACU;AACV,UAAM,WAAW,IAAI,IAAI,WAAW;AACpC,aAAS,aAAa,IAAI,SAAS,KAAK;AACxC,QAAI,YAAa,UAAS,aAAa,IAAI,qBAAqB,WAAW;AAC3E,UAAM,QAAQ,WAAW,aAAa,IAAI,OAAO;AACjD,QAAI,MAAO,UAAS,aAAa,IAAI,SAAS,KAAK;AACnD,WAAO,SAAS,SAAS,UAAU,GAAG;AAAA,EACxC;AAAA,EAEQ,MAAM,QAA0B;AACtC,UAAM,OAAO,IAAI,gBAAgB,MAAM;AACvC,UAAM,YAAY,UAAU,MAAM,YAAY;AAC9C,QAAI,cAAc,qBAAsB,QAAO,KAAK,0BAA0B,IAAI;AAClF,QAAI,cAAc,gBAAiB,QAAO,KAAK,qBAAqB,IAAI;AACxE,WAAO,WAAW,KAAK,0BAA0B,iCAAiC;AAAA,EACpF;AAAA,EAEQ,0BAA0B,MAAiC;AACjE,UAAM,OAAO,UAAU,MAAM,MAAM;AACnC,UAAM,SAAS,OAAO,KAAK,MAAM,IAAI,IAAI,IAAI;AAC7C,QAAI,CAAC,UAAU,OAAO,QAAQ,OAAO,aAAa,KAAK,WAAW,GAAG;AACnE,aAAO,WAAW,KAAK,iBAAiB,0CAA0C;AAAA,IACpF;AACA,QACE,UAAU,MAAM,WAAW,MAAM,OAAO,YACxC,UAAU,MAAM,cAAc,MAAM,OAAO,aAC3C;AACA,aAAO,WAAW,KAAK,iBAAiB,2CAA2C;AAAA,IACrF;AACA,UAAM,WAAW,UAAU,MAAM,eAAe;AAChD,UAAM,YAAY,eACd,+BAAW,QAAQ,EAAE,OAAO,QAAQ,EAAE,OAAO,WAAW,IACxD;AACJ,QAAI,cAAc,OAAO,eAAe;AACtC,aAAO,WAAW,KAAK,iBAAiB,0BAA0B;AAAA,IACpE;AACA,WAAO,OAAO;AACd,WAAO,KAAK,KAAK,KAAK,cAAc,MAAM,CAAC;AAAA,EAC7C;AAAA,EAEQ,qBAAqB,MAAiC;AAC5D,UAAM,eAAe,UAAU,MAAM,eAAe;AACpD,UAAM,SAAS,eAAe,KAAK,cAAc,IAAI,YAAY,IAAI;AACrE,QAAI,CAAC,UAAU,OAAO,WAAW,OAAO,aAAa,KAAK,WAAW,GAAG;AACtE,aAAO,WAAW,KAAK,iBAAiB,qCAAqC;AAAA,IAC/E;AACA,QAAI,UAAU,MAAM,WAAW,MAAM,OAAO,UAAU;AACpD,aAAO,WAAW,KAAK,iBAAiB,6CAA6C;AAAA,IACvF;AACA,UAAM,kBAAkB,KAAK,IAAI,OAAO,IACpC,aAAa,KAAK,IAAI,OAAO,CAAC,IAC9B,OAAO;AACX,QAAI,gBAAgB,KAAK,CAAC,UAAU,CAAC,OAAO,OAAO,SAAS,KAAK,CAAC,GAAG;AACnE,aAAO,WAAW,KAAK,iBAAiB,wCAAwC;AAAA,IAClF;AACA,WAAO,UAAU;AACjB,WAAO,KAAK,KAAK,KAAK,cAAc,EAAE,GAAG,QAAQ,QAAQ,gBAAgB,CAAC,CAAC;AAAA,EAC7E;AAAA,EAEQ,cACN,OACwB;AACxB,UAAM,cAAc,oBAAgB,+BAAW,CAAC;AAChD,UAAM,eAAe,qBAAiB,+BAAW,CAAC;AAClD,SAAK,aAAa,IAAI,aAAa;AAAA,MACjC,GAAG;AAAA,MACH,WAAW,KAAK,WAAW,IAAI,KAAK;AAAA,MACpC,SAAS;AAAA,IACX,CAAC;AACD,SAAK,cAAc,IAAI,cAAc;AAAA,MACnC,GAAG;AAAA,MACH,WAAW,KAAK,WAAW,IAAI,KAAK;AAAA,MACpC,SAAS;AAAA,IACX,CAAC;AACD,WAAO;AAAA,MACL,cAAc;AAAA,MACd,YAAY;AAAA,MACZ,YAAY,KAAK;AAAA,MACjB,eAAe;AAAA,MACf,OAAO,MAAM,OAAO,KAAK,GAAG;AAAA,MAC5B,GAAI,MAAM,WAAW,EAAE,UAAU,MAAM,SAAS,IAAI,CAAC;AAAA,IACvD;AAAA,EACF;AAAA,EAEQ,OAAO,QAA0B;AACvC,UAAM,QAAQ,IAAI,gBAAgB,MAAM,EAAE,IAAI,OAAO;AACrD,QAAI,MAAO,MAAK,YAAY,KAAK;AACjC,WAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,IAAI,CAAC;AAAA,EAC3C;AACF;AAcA,eAAe,UAAU,KAAsB,QAAkC;AAC/E,QAAM,SAAmB,CAAC;AAC1B,mBAAiB,SAAS,IAAK,QAAO,KAAK,OAAO,KAAK,KAAK,CAAC;AAC7D,QAAM,UAAU,IAAI,QAAQ;AAC5B,aAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ,IAAI,OAAO,GAAG;AACvD,QAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,iBAAW,SAAS,MAAO,SAAQ,OAAO,MAAM,KAAK;AAAA,IACvD,WAAW,UAAU,QAAW;AAC9B,cAAQ,IAAI,MAAM,KAAK;AAAA,IACzB;AAAA,EACF;AACA,QAAM,OAAO,OAAO,SAAS,OAAO,OAAO,MAAM,IAAI;AACrD,QAAM,OAA0C;AAAA,IAC9C,QAAQ,IAAI;AAAA,IACZ;AAAA,IACA,GAAI,OAAO,EAAE,MAAM,QAAQ,OAAO,IAAI,CAAC;AAAA,EACzC;AACA,SAAO,IAAI,QAAQ,IAAI,IAAI,IAAI,OAAO,KAAK,MAAM,GAAG,IAAI;AAC1D;AAEA,eAAe,cAAc,KAAqB,UAAmC;AACnF,MAAI,aAAa,SAAS;AAC1B,WAAS,QAAQ,QAAQ,CAAC,OAAO,SAAS,IAAI,UAAU,MAAM,KAAK,CAAC;AACpE,MAAI,IAAI,OAAO,KAAK,MAAM,SAAS,YAAY,CAAC,CAAC;AACnD;AAEA,eAAsB,kCACpB,UAA4C,CAAC,GACP;AACtC,MAAI;AACJ,MAAI,SAAS;AACb,QAAM,aAAS,+BAAa,OAAO,KAAK,QAAQ;AAC9C,QAAI;AACF,UAAI,CAAC,MAAO,OAAM,IAAI,MAAM,sCAAsC;AAClE,YAAM,cAAc,KAAK,MAAM,MAAM,OAAO,MAAM,UAAU,KAAK,MAAM,CAAC,CAAC;AAAA,IAC3E,QAAQ;AACN,UAAI,aAAa;AACjB,UAAI,UAAU,gBAAgB,kBAAkB;AAChD,UAAI,IAAI,KAAK,UAAU;AAAA,QACrB,OAAO;AAAA,QACP,mBAAmB;AAAA,MACrB,CAAC,CAAC;AAAA,IACJ;AAAA,EACF,CAAC;AACD,QAAM,IAAI,QAAc,CAAC,SAAS,WAAW;AAC3C,WAAO,KAAK,SAAS,MAAM;AAC3B,WAAO,OAAO,QAAQ,QAAQ,GAAG,QAAQ,YAAY,aAAa,MAAM;AACtE,aAAO,IAAI,SAAS,MAAM;AAC1B,cAAQ;AAAA,IACV,CAAC;AAAA,EACH,CAAC;AACD,QAAM,UAAU,OAAO,QAAQ;AAC/B,WAAS,UAAU,QAAQ,QAAQ,SAAS,GAAG,IAAI,IAAI,QAAQ,OAAO,MAAM,QAAQ,OAAO,IAAI,QAAQ,IAAI;AAC3G,UAAQ,IAAI,kCAAkC,EAAE,GAAG,SAAS,QAAQ,OAAO,CAAC;AAC5E,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,OAAO,MAAM,IAAI,QAAc,CAAC,SAAS,WAAW;AAClD,aAAO,MAAM,CAAC,UAAU,QAAQ,OAAO,KAAK,IAAI,QAAQ,CAAC;AAAA,IAC3D,CAAC;AAAA,EACH;AACF;;;ACxfA,oBAAuB;AACvB,sBAAkC;AAgBlC,mBAGO;AASA,IAAM,kBAAN,MAAM,iBAAsC;AAAA,EACxC;AAAA,EACQ;AAAA,EACT,SAAS;AAAA,EAET,YAAY,QAAgB,QAA+B;AACjE,SAAK,SAAS;AACd,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,aAAa,QACX,QACA,OAAO,EAAE,MAAM,qBAAqB,SAAS,QAAQ,GACrD,UAAkC,CAAC,GACC;AACpC,UAAM,CAAC,iBAAiB,eAAe,IAAI,kCAAkB,iBAAiB;AAC9E,UAAM,SAAS,IAAI,qBAAO,MAAM,EAAE,cAAc,QAAQ,gBAAgB,CAAC,EAAE,CAAC;AAC5E,UAAM,QAAQ,YAAY,MAAM;AAChC,UAAM,OAAO,QAAQ,eAAe;AACpC,UAAM,OAAO,QAAQ,eAAe;AACpC,WAAO,IAAI,iBAAgB,QAAQ,MAAM;AAAA,EAC3C;AAAA,EAEA,MAAM,YAA6B;AACjC,UAAM,SAAiB,CAAC;AACxB,QAAI;AACJ,OAAG;AACD,YAAM,OAAO,MAAM,KAAK,OAAO,UAAU,SAAS,EAAE,OAAO,IAAI,MAAS;AACxE,aAAO,KAAK,GAAG,KAAK,KAAK;AACzB,eAAS,KAAK;AAAA,IAChB,SAAS;AACT,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,SACJ,MACA,OAAgC,CAAC,GACR;AACzB,WAAQ,MAAM,KAAK,OAAO,SAAS,EAAE,MAAM,WAAW,KAAK,CAAC;AAAA,EAC9D;AAAA,EAEA,MAAM,eACJ,MACA,OAAgC,CAAC,GACjC,UAA4B,CAAC,GACF;AAC3B,WAAO,KAAK,OAAO;AAAA,MACjB;AAAA,QACE,QAAQ;AAAA,QACR,QAAQ,EAAE,MAAM,WAAW,MAAM,MAAM,QAAQ;AAAA,MACjD;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EAEA,QAAQ,QAA+B;AACrC,WAAO,KAAK,OAAO,aAAa,MAAM,QAAQ,MAAM;AAAA,EACtD;AAAA,EAEA,cAAc,QAAyC;AACrD,WAAO,KAAK,OAAO,aAAa,MAAM;AAAA,MACpC;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EAEA,UAAU,QAA2C;AACnD,WAAO,KAAK,OAAO,aAAa,MAAM,UAAU,MAAM;AAAA,EACxD;AAAA,EAEA,WAAW,QAA+B;AACxC,WAAO,KAAK,OAAO,aAAa,MAAM,WAAW,MAAM;AAAA,EACzD;AAAA,EAEA,MAAM,gBAAqC;AACzC,UAAM,SAAqB,CAAC;AAC5B,QAAI;AACJ,OAAG;AACD,YAAM,OAAO,MAAM,KAAK,OAAO,cAAc,SAAS,EAAE,OAAO,IAAI,MAAS;AAC5E,aAAO,KAAK,GAAG,KAAK,SAAS;AAC7B,eAAS,KAAK;AAAA,IAChB,SAAS;AACT,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,wBAAqD;AACzD,UAAM,SAA6B,CAAC;AACpC,QAAI;AACJ,OAAG;AACD,YAAM,OAAO,MAAM,KAAK,OAAO,sBAAsB,SAAS,EAAE,OAAO,IAAI,MAAS;AACpF,aAAO,KAAK,GAAG,KAAK,iBAAiB;AACrC,eAAS,KAAK;AAAA,IAChB,SAAS;AACT,WAAO;AAAA,EACT;AAAA,EAEA,aAAa,KAA0C;AACrD,WAAO,KAAK,OAAO,aAAa,EAAE,IAAI,CAAC;AAAA,EACzC;AAAA,EAEA,MAAM,kBAAkB,KAA4B;AAClD,UAAM,KAAK,OAAO,kBAAkB,EAAE,IAAI,CAAC;AAAA,EAC7C;AAAA,EAEA,MAAM,oBAAoB,KAA4B;AACpD,UAAM,KAAK,OAAO,oBAAoB,EAAE,IAAI,CAAC;AAAA,EAC/C;AAAA,EAEA,MAAM,cAAiC;AACrC,UAAM,SAAmB,CAAC;AAC1B,QAAI;AACJ,OAAG;AACD,YAAM,OAAO,MAAM,KAAK,OAAO,YAAY,SAAS,EAAE,OAAO,IAAI,MAAS;AAC1E,aAAO,KAAK,GAAG,KAAK,OAAO;AAC3B,eAAS,KAAK;AAAA,IAChB,SAAS;AACT,WAAO;AAAA,EACT;AAAA,EAEA,UACE,MACA,MAC0B;AAC1B,WAAO,KAAK,OAAO,UAAU,EAAE,MAAM,GAAI,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC,EAAG,CAAC;AAAA,EAC7E;AAAA,EAEA,SAAS,QAA4D;AACnE,WAAO,KAAK,OAAO,SAAS,MAAM;AAAA,EACpC;AAAA,EAEA,MAAM,QAAuB;AAC3B,QAAI,KAAK,OAAQ;AACjB,SAAK,SAAS;AACd,UAAM,KAAK,OAAO,MAAM,EAAE,MAAM,MAAM,MAAS;AAC/C,UAAM,KAAK,OAAO,MAAM,EAAE,MAAM,MAAM,MAAS;AAAA,EACjD;AACF;;;ACrKA,gCAAsB;AACtB,qBAA2B;AAC3B,uBAAiB;AAEV,IAAM,+BAA+B;AAoB5C,SAAS,cAAc,MAAqD;AAC1E,MAAI,QAAQ,aAAa,QAAS,QAAO,EAAE,SAAS,OAAO,KAAK;AAChE,QAAM,cAAc,QAAQ,IAAI;AAChC,QAAM,aAAa;AAAA,IACjB,cAAc,iBAAAC,QAAK,KAAK,iBAAAA,QAAK,QAAQ,WAAW,GAAG,YAAY,IAAI;AAAA,IACnE,iBAAAA,QAAK,QAAQ,iBAAAA,QAAK,QAAQ,QAAQ,QAAQ,GAAG,iCAAiC;AAAA,IAC9E,iBAAAA,QAAK,QAAQ,iBAAAA,QAAK,QAAQ,QAAQ,QAAQ,GAAG,wCAAwC;AAAA,EACvF,EAAE,OAAO,CAAC,cAAmC,QAAQ,SAAS,CAAC;AAC/D,QAAM,SAAS,WAAW,KAAK,CAAC,kBAAc,2BAAW,SAAS,CAAC;AACnE,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,2EAA2E;AAAA,EAC7F;AACA,SAAO,EAAE,SAAS,QAAQ,UAAU,MAAM,CAAC,QAAQ,GAAG,IAAI,EAAE;AAC9D;AAEO,SAAS,6BACd,SACU;AACV,QAAM,OAAO;AAAA,IACX;AAAA,IACA,qCAAqC,4BAA4B;AAAA,IACjE;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,EACV;AACA,MAAI,QAAQ,MAAO,MAAK,KAAK,WAAW,QAAQ,KAAK;AACrD,MAAI,QAAQ,SAAU,MAAK,KAAK,cAAc,QAAQ,QAAQ;AAC9D,MAAI,QAAQ,kBAAkB;AAC5B,SAAK,KAAK,uBAAuB,QAAQ,gBAAgB;AAAA,EAC3D;AACA,MAAI,QAAQ,UAAW,MAAK,KAAK,gBAAgB,QAAQ,SAAS;AAClE,MAAI,QAAQ,YAAa,MAAK,KAAK,kBAAkB,QAAQ,WAAW;AACxE,MAAI,QAAQ,QAAS,MAAK,KAAK,WAAW;AAC1C,SAAO;AACT;AAEA,eAAsB,uBACpB,SACoC;AACpC,QAAM,YAAY,OAAO,SAAS,QAAQ,SAAS,KAAK,MAAM,GAAG,EAAE,CAAC,KAAK,KAAK,EAAE;AAChF,MAAI,YAAY,IAAI;AAClB,UAAM,IAAI;AAAA,MACR,4BAA4B,4BAA4B,qDAAqD,QAAQ,SAAS,IAAI;AAAA,IACpI;AAAA,EACF;AACA,QAAM,OAAO,6BAA6B,OAAO;AACjD,QAAM,aAAa,cAAc,IAAI;AAErC,SAAO,MAAM,IAAI,QAAmC,CAAC,SAAS,WAAW;AACvE,UAAM,YAAQ,iCAAM,WAAW,SAAS,WAAW,MAAM;AAAA,MACvD,KAAK,QAAQ;AAAA,MACb,KAAK;AAAA,QACH,GAAG,QAAQ;AAAA,QACX,MAAM,CAAC,iBAAAA,QAAK,QAAQ,QAAQ,QAAQ,GAAG,QAAQ,IAAI,IAAI,EACpD,OAAO,OAAO,EACd,KAAK,iBAAAA,QAAK,SAAS;AAAA,MACxB;AAAA,MACA,OAAO,QAAQ,UAAU,YAAY,YAAY;AAAA,IACnD,CAAC;AACD,QAAI,SAAS;AACb,QAAI,SAAS;AACb,UAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU;AAClC,gBAAU,MAAM,SAAS;AAAA,IAC3B,CAAC;AACD,UAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU;AAClC,gBAAU,MAAM,SAAS;AAAA,IAC3B,CAAC;AACD,UAAM,KAAK,SAAS,MAAM;AAC1B,UAAM,KAAK,SAAS,CAAC,SAAS;AAC5B,cAAQ,EAAE,UAAU,QAAQ,GAAG,QAAQ,OAAO,CAAC;AAAA,IACjD,CAAC;AAAA,EACH,CAAC;AACH;;;AChGA,kBAGO;AAoCA,IAAM,sBAAsB;AAAA,EACjC,WAAW;AAAA,IACT,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,kBAAkB,CAAC,cAAc,cAAc,YAAY;AAAA,IAC3D,gBAAgB,CAAC,OAAO;AAAA,EAC1B;AAAA,EACA,cAAc;AAAA,IACZ,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,kBAAkB,CAAC,cAAc,cAAc,YAAY;AAAA,IAC3D,gBAAgB,CAAC,SAAS,aAAa,WAAW,eAAe,SAAS,SAAS;AAAA,IACnF,gBAAgB,EAAE,UAAU,MAAM,aAAa,CAAC,QAAQ,KAAK,GAAG,OAAO,KAAK;AAAA,EAC9E;AAAA,EACA,SAAS;AAAA,IACP,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,kBAAkB,CAAC,YAAY;AAAA,IAC/B,gBAAgB,CAAC,SAAS,aAAa,WAAW,eAAe,SAAS,SAAS;AAAA,IACnF,gBAAgB,EAAE,UAAU,MAAM,aAAa,CAAC,QAAQ,KAAK,GAAG,OAAO,KAAK;AAAA,IAC5E,YAAY,CAAC,gCAAoB;AAAA,EACnC;AACF;AAEO,SAAS,uBACd,UACA,SAC8B;AAC9B,QAAM,SAAwC,CAAC;AAC/C,MACE,SAAS,kBAAkB,UAC3B,CAAC,SAAS,iBAAiB,KAAK,CAAC,YAAY,QAAQ,iBAAiB,SAAS,OAAO,CAAC,GACvF;AACA,WAAO,KAAK;AAAA,MACV,UAAU;AAAA,MACV,MAAM;AAAA,MACN,MAAM;AAAA,MACN,SAAS,GAAG,QAAQ,IAAI,QAAQ,SAAS,OAAO,IAAI;AAAA,IACtD,CAAC;AAAA,EACH;AAEA,QAAM,0BAA0B,IAAI,IAAI,QAAQ,cAAc;AAC9D,aAAW,WAAW,OAAO,KAAK,SAAS,gBAAgB,CAAC,CAAC,GAAG;AAC9D,QACE,YAAY,kBACZ,wBAAwB,IAAI,OAA6B,EACzD;AACF,WAAO,KAAK;AAAA,MACV,UAAU;AAAA,MACV,MAAM;AAAA,MACN,MAAM,gBAAgB,OAAO;AAAA,MAC7B,SAAS,GAAG,QAAQ,IAAI,iCAAiC,OAAO;AAAA,IAClE,CAAC;AAAA,EACH;AAEA,QAAM,WAAW,SAAS;AAC1B,MAAI,UAAU,YAAY,CAAC,QAAQ,gBAAgB,UAAU;AAC3D,WAAO,KAAK;AAAA,MACV,UAAU;AAAA,MACV,MAAM;AAAA,MACN,MAAM;AAAA,MACN,SAAS,GAAG,SAAS,OAAO,IAAI;AAAA,IAClC,CAAC;AAAA,EACH;AACA,MAAI,UAAU,SAAS,CAAC,QAAQ,gBAAgB,OAAO;AACrD,WAAO,KAAK;AAAA,MACV,UAAU;AAAA,MACV,MAAM;AAAA,MACN,MAAM;AAAA,MACN,SAAS,GAAG,SAAS,OAAO,IAAI;AAAA,IAClC,CAAC;AAAA,EACH;AACA,aAAW,QAAQ,UAAU,eAAe,CAAC,GAAG;AAC9C,QAAI,CAAC,QAAQ,gBAAgB,aAAa,SAAS,IAAI,GAAG;AACxD,aAAO,KAAK;AAAA,QACV,UAAU;AAAA,QACV,MAAM;AAAA,QACN,MAAM,kCAAkC,IAAI;AAAA,QAC5C,SAAS,GAAG,SAAS,OAAO,IAAI,aAAa,IAAI;AAAA,MACnD,CAAC;AAAA,IACH;AAAA,EACF;AAEA,QAAM,aAAa,IAAI,IAAI,QAAQ,cAAc,CAAC,CAAC;AACnD,aAAW,CAAC,WAAW,aAAa,KAAK,OAAO,QAAQ,SAAS,cAAc,CAAC,CAAC,GAAG;AAClF,QAAI,WAAW,IAAI,SAAS,EAAG;AAC/B,UAAM,oBACJ,iBAAiB,OAAO,kBAAkB,YACzC,cAA0C,aAAa;AAC1D,WAAO,KAAK;AAAA,MACV,UAAU,oBAAoB,iBAAiB;AAAA,MAC/C,MAAM;AAAA,MACN,MAAM,cAAc,SAAS;AAAA,MAC7B,SAAS,GAAG,QAAQ,IAAI,qBAAqB,SAAS;AAAA,IACxD,CAAC;AAAA,EACH;AAEA,MAAI,CAAC,WAAW,IAAI,gCAAoB,GAAG;AACzC,eAAW,QAAQ,SAAS,OAAO;AACjC,YAAM,KAAK,KAAK,UAAU;AAC1B,UAAI,IAAI,YAAY,UAAU,CAAC,GAAG,WAAW,SAAS,OAAO,GAAG;AAC9D,eAAO,KAAK;AAAA,UACV,UAAU;AAAA,UACV,MAAM;AAAA,UACN,MAAM,SAAS,KAAK,IAAI;AAAA,UACxB,SAAS,GAAG,KAAK,IAAI,oBAAoB,QAAQ,IAAI;AAAA,QACvD,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAEA,SAAO,KAAK,CAAC,MAAM,UAAU,KAAK,KAAK,cAAc,MAAM,IAAI,KAAK,KAAK,KAAK,cAAc,MAAM,IAAI,CAAC;AACvG,QAAM,SAAS,OAAO,KAAK,CAAC,UAAU,MAAM,aAAa,cAAc,IACnE,iBACA,OAAO,SACL,aACA;AACN,SAAO,EAAE,QAAQ,YAAY,WAAW,gBAAgB,OAAO;AACjE;;;ACpIA,eAAsB,aACpB,QACA,WACgC;AAChC,QAAM,UAAiC,CAAC;AACxC,aAAW,YAAY,WAAW;AAChC,UAAM,YAAY,YAAY,IAAI;AAClC,QAAI;AACF,YAAM,SAAS,MAAM,OAAO,SAAS,SAAS,MAAM,SAAS,SAAS;AACtE,UAAI,OAAO,WAAW,SAAS,QAAQ,YAAY,QAAW;AAC5D,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AAAA,MACF;AACA,UACE,SAAS,QAAQ,YAAY,UAC7B,QAAQ,OAAO,OAAO,MAAM,SAAS,OAAO,SAC5C;AACA,cAAM,IAAI;AAAA,UACR,oBAAoB,SAAS,OAAO,OAAO,cAAc,QAAQ,OAAO,OAAO,CAAC;AAAA,QAClF;AAAA,MACF;AACA,UACE,SAAS,UACT,OAAO,UAAU,eAAe,KAAK,SAAS,QAAQ,mBAAmB,KACzE,WAAW,OAAO,iBAAiB,MACjC,WAAW,SAAS,OAAO,iBAAiB,GAC9C;AACA,cAAM,IAAI;AAAA,UACR;AAAA,YAAyC,WAAW,SAAS,OAAO,iBAAiB,CAAC;AAAA,YAAe,WAAW,OAAO,iBAAiB,CAAC;AAAA,QAC3I;AAAA,MACF;AACA,UAAI,SAAS,QAAQ,sBAAsB;AACzC,mCAA2B,MAAM;AAAA,MACnC;AACA,YAAM,SAAS,SAAS,MAAM;AAC9B,cAAQ,KAAK;AAAA,QACX,MAAM,SAAS;AAAA,QACf,MAAM,SAAS;AAAA,QACf,QAAQ;AAAA,QACR,YAAY,YAAY,IAAI,IAAI;AAAA,MAClC,CAAC;AAAA,IACH,SAAS,OAAO;AACd,cAAQ,KAAK;AAAA,QACX,MAAM,SAAS;AAAA,QACf,MAAM,SAAS;AAAA,QACf,QAAQ;AAAA,QACR,YAAY,YAAY,IAAI,IAAI;AAAA,QAChC,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,MAC9D,CAAC;AAAA,IACH;AAAA,EACF;AACA,SAAO;AACT;","names":["path","path"]}
|
package/dist/index.d.cts
ADDED
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
import { ClientCapabilities, Tool, CallToolResult, CreateTaskResult, Task, ListTasksResult, Resource, ResourceTemplate, ReadResourceResult, Prompt, GetPromptResult, CompleteRequest, CompleteResult } from '@modelcontextprotocol/sdk/types.js';
|
|
2
|
+
import { McpFnServer, McpFnManifest } from '@mcpfn/core';
|
|
3
|
+
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
|
|
4
|
+
export { MCPFN_OAUTH_EXTENSION_GRANTS, McpFnAuthAssertionError, McpFnAuthCredential, McpFnAuthCredentialKind, McpFnAuthCredentialRequest, McpFnAuthProbeScenario, McpFnAuthProviderAdapter, McpFnAuthProviderCapabilities, McpFnAuthRegressionOptions, McpFnAuthScenarioResult, McpFnAuthTarget, McpFnBearerChallenge, McpFnFetchAuthTargetOptions, McpFnMockOAuthAuthorizationServer, McpFnMockOAuthServerOptions, McpFnMockOAuthTokenSet, McpFnOAuthCallback, McpFnOAuthClientMetadata, McpFnOAuthClientMetadataFixtureOptions, McpFnOAuthClientMetadataVariants, McpFnPkcePair, McpFnStartMockOAuthServerOptions, McpFnStartedMockOAuthServer, apiKeyCredential, assertAuthRegressionSuite, assertAuthorizationCodeClientMetadata, assertBearerResourceChallenge, bearerCredential, createFetchAuthTarget, createOAuthClientMetadataFixture, createOAuthClientMetadataVariants, createPkcePair, parseBearerChallenge, runAuthRegressionSuite, startMockOAuthAuthorizationServer } from './auth.cjs';
|
|
5
|
+
import '@modelcontextprotocol/sdk/server/auth/types.js';
|
|
6
|
+
|
|
7
|
+
interface McpFnTestClientOptions {
|
|
8
|
+
capabilities?: ClientCapabilities;
|
|
9
|
+
/** Install roots, sampling, elicitation, or notification handlers before initialize. */
|
|
10
|
+
configure?(client: Client): void | Promise<void>;
|
|
11
|
+
}
|
|
12
|
+
declare class McpFnTestClient<TContext = undefined> {
|
|
13
|
+
readonly client: Client;
|
|
14
|
+
private readonly server;
|
|
15
|
+
private closed;
|
|
16
|
+
private constructor();
|
|
17
|
+
static connect<TContext>(server: McpFnServer<TContext>, info?: {
|
|
18
|
+
name: string;
|
|
19
|
+
version: string;
|
|
20
|
+
}, options?: McpFnTestClientOptions): Promise<McpFnTestClient<TContext>>;
|
|
21
|
+
listTools(): Promise<Tool[]>;
|
|
22
|
+
callTool(name: string, args?: Record<string, unknown>): Promise<CallToolResult>;
|
|
23
|
+
createToolTask(name: string, args?: Record<string, unknown>, options?: {
|
|
24
|
+
ttl?: number;
|
|
25
|
+
}): Promise<CreateTaskResult>;
|
|
26
|
+
getTask(taskId: string): Promise<Task>;
|
|
27
|
+
getTaskResult(taskId: string): Promise<CallToolResult>;
|
|
28
|
+
listTasks(cursor?: string): Promise<ListTasksResult>;
|
|
29
|
+
cancelTask(taskId: string): Promise<Task>;
|
|
30
|
+
listResources(): Promise<Resource[]>;
|
|
31
|
+
listResourceTemplates(): Promise<ResourceTemplate[]>;
|
|
32
|
+
readResource(uri: string): Promise<ReadResourceResult>;
|
|
33
|
+
subscribeResource(uri: string): Promise<void>;
|
|
34
|
+
unsubscribeResource(uri: string): Promise<void>;
|
|
35
|
+
listPrompts(): Promise<Prompt[]>;
|
|
36
|
+
getPrompt(name: string, args?: Record<string, string>): Promise<GetPromptResult>;
|
|
37
|
+
complete(params: CompleteRequest["params"]): Promise<CompleteResult>;
|
|
38
|
+
close(): Promise<void>;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
declare function stableJson(value: unknown): string;
|
|
42
|
+
declare class McpFnAssertionError extends Error {
|
|
43
|
+
constructor(message: string);
|
|
44
|
+
}
|
|
45
|
+
interface AssertManifestContractOptions {
|
|
46
|
+
/** Exact tools expected to be visible for the test client's request context. */
|
|
47
|
+
expectedToolNames?: readonly string[];
|
|
48
|
+
}
|
|
49
|
+
declare function assertManifestContract(client: McpFnTestClient<unknown>, manifest: McpFnManifest, options?: AssertManifestContractOptions): Promise<Tool[]>;
|
|
50
|
+
declare function assertStructuredTextParity(result: {
|
|
51
|
+
content?: unknown[];
|
|
52
|
+
structuredContent?: Record<string, unknown>;
|
|
53
|
+
}): void;
|
|
54
|
+
|
|
55
|
+
declare const OFFICIAL_CONFORMANCE_VERSION = "0.1.16";
|
|
56
|
+
interface OfficialConformanceOptions {
|
|
57
|
+
url: string;
|
|
58
|
+
suite?: "active" | "all" | "pending";
|
|
59
|
+
scenario?: string;
|
|
60
|
+
expectedFailures?: string;
|
|
61
|
+
outputDir?: string;
|
|
62
|
+
specVersion?: string;
|
|
63
|
+
verbose?: boolean;
|
|
64
|
+
cwd?: string;
|
|
65
|
+
stdio?: "inherit" | "pipe";
|
|
66
|
+
}
|
|
67
|
+
interface OfficialConformanceResult {
|
|
68
|
+
exitCode: number;
|
|
69
|
+
stdout: string;
|
|
70
|
+
stderr: string;
|
|
71
|
+
}
|
|
72
|
+
declare function buildOfficialConformanceArgs(options: OfficialConformanceOptions): string[];
|
|
73
|
+
declare function runOfficialConformance(options: OfficialConformanceOptions): Promise<OfficialConformanceResult>;
|
|
74
|
+
|
|
75
|
+
type McpFnServerFeature = "tools" | "resources" | "prompts" | "completions" | "tasks" | "logging";
|
|
76
|
+
interface McpFnHostProfile {
|
|
77
|
+
id: string;
|
|
78
|
+
name: string;
|
|
79
|
+
protocolVersions: string[];
|
|
80
|
+
serverFeatures: McpFnServerFeature[];
|
|
81
|
+
clientFeatures?: {
|
|
82
|
+
sampling?: boolean;
|
|
83
|
+
elicitation?: Array<"form" | "url">;
|
|
84
|
+
roots?: boolean;
|
|
85
|
+
};
|
|
86
|
+
extensions?: string[];
|
|
87
|
+
}
|
|
88
|
+
interface McpFnHostCompatibilityIssue {
|
|
89
|
+
severity: "incompatible" | "degraded";
|
|
90
|
+
code: string;
|
|
91
|
+
path: string;
|
|
92
|
+
message: string;
|
|
93
|
+
}
|
|
94
|
+
interface McpFnHostCompatibilityResult {
|
|
95
|
+
status: "compatible" | "degraded" | "incompatible";
|
|
96
|
+
compatible: boolean;
|
|
97
|
+
issues: McpFnHostCompatibilityIssue[];
|
|
98
|
+
}
|
|
99
|
+
declare const MCPFN_HOST_PROFILES: {
|
|
100
|
+
readonly toolsOnly: {
|
|
101
|
+
readonly id: "mcpfn/tools-only";
|
|
102
|
+
readonly name: "Tools-only MCP host";
|
|
103
|
+
readonly protocolVersions: ["2025-03-26", "2025-06-18", "2025-11-25"];
|
|
104
|
+
readonly serverFeatures: ["tools"];
|
|
105
|
+
};
|
|
106
|
+
readonly fullProtocol: {
|
|
107
|
+
readonly id: "mcpfn/full-protocol";
|
|
108
|
+
readonly name: "Full protocol MCP host";
|
|
109
|
+
readonly protocolVersions: ["2025-03-26", "2025-06-18", "2025-11-25"];
|
|
110
|
+
readonly serverFeatures: ["tools", "resources", "prompts", "completions", "tasks", "logging"];
|
|
111
|
+
readonly clientFeatures: {
|
|
112
|
+
readonly sampling: true;
|
|
113
|
+
readonly elicitation: ["form", "url"];
|
|
114
|
+
readonly roots: true;
|
|
115
|
+
};
|
|
116
|
+
};
|
|
117
|
+
readonly mcpApps: {
|
|
118
|
+
readonly id: "mcpfn/mcp-apps";
|
|
119
|
+
readonly name: "Full protocol host with MCP Apps";
|
|
120
|
+
readonly protocolVersions: ["2025-11-25"];
|
|
121
|
+
readonly serverFeatures: ["tools", "resources", "prompts", "completions", "tasks", "logging"];
|
|
122
|
+
readonly clientFeatures: {
|
|
123
|
+
readonly sampling: true;
|
|
124
|
+
readonly elicitation: ["form", "url"];
|
|
125
|
+
readonly roots: true;
|
|
126
|
+
};
|
|
127
|
+
readonly extensions: ["io.modelcontextprotocol/ui"];
|
|
128
|
+
};
|
|
129
|
+
};
|
|
130
|
+
declare function checkHostCompatibility(manifest: McpFnManifest, profile: McpFnHostProfile): McpFnHostCompatibilityResult;
|
|
131
|
+
|
|
132
|
+
interface McpFnScenario {
|
|
133
|
+
name: string;
|
|
134
|
+
tool: string;
|
|
135
|
+
arguments?: Record<string, unknown>;
|
|
136
|
+
expect?: {
|
|
137
|
+
isError?: boolean;
|
|
138
|
+
structuredContent?: unknown;
|
|
139
|
+
structuredTextParity?: boolean;
|
|
140
|
+
};
|
|
141
|
+
verify?(result: CallToolResult): void | Promise<void>;
|
|
142
|
+
}
|
|
143
|
+
interface McpFnScenarioResult {
|
|
144
|
+
name: string;
|
|
145
|
+
tool: string;
|
|
146
|
+
status: "passed" | "failed";
|
|
147
|
+
durationMs: number;
|
|
148
|
+
error?: string;
|
|
149
|
+
}
|
|
150
|
+
declare function runScenarios(client: McpFnTestClient<unknown>, scenarios: McpFnScenario[]): Promise<McpFnScenarioResult[]>;
|
|
151
|
+
|
|
152
|
+
export { type AssertManifestContractOptions, MCPFN_HOST_PROFILES, McpFnAssertionError, type McpFnHostCompatibilityIssue, type McpFnHostCompatibilityResult, type McpFnHostProfile, type McpFnScenario, type McpFnScenarioResult, type McpFnServerFeature, McpFnTestClient, type McpFnTestClientOptions, OFFICIAL_CONFORMANCE_VERSION, type OfficialConformanceOptions, type OfficialConformanceResult, assertManifestContract, assertStructuredTextParity, buildOfficialConformanceArgs, checkHostCompatibility, runOfficialConformance, runScenarios, stableJson };
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
import { ClientCapabilities, Tool, CallToolResult, CreateTaskResult, Task, ListTasksResult, Resource, ResourceTemplate, ReadResourceResult, Prompt, GetPromptResult, CompleteRequest, CompleteResult } from '@modelcontextprotocol/sdk/types.js';
|
|
2
|
+
import { McpFnServer, McpFnManifest } from '@mcpfn/core';
|
|
3
|
+
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
|
|
4
|
+
export { MCPFN_OAUTH_EXTENSION_GRANTS, McpFnAuthAssertionError, McpFnAuthCredential, McpFnAuthCredentialKind, McpFnAuthCredentialRequest, McpFnAuthProbeScenario, McpFnAuthProviderAdapter, McpFnAuthProviderCapabilities, McpFnAuthRegressionOptions, McpFnAuthScenarioResult, McpFnAuthTarget, McpFnBearerChallenge, McpFnFetchAuthTargetOptions, McpFnMockOAuthAuthorizationServer, McpFnMockOAuthServerOptions, McpFnMockOAuthTokenSet, McpFnOAuthCallback, McpFnOAuthClientMetadata, McpFnOAuthClientMetadataFixtureOptions, McpFnOAuthClientMetadataVariants, McpFnPkcePair, McpFnStartMockOAuthServerOptions, McpFnStartedMockOAuthServer, apiKeyCredential, assertAuthRegressionSuite, assertAuthorizationCodeClientMetadata, assertBearerResourceChallenge, bearerCredential, createFetchAuthTarget, createOAuthClientMetadataFixture, createOAuthClientMetadataVariants, createPkcePair, parseBearerChallenge, runAuthRegressionSuite, startMockOAuthAuthorizationServer } from './auth.js';
|
|
5
|
+
import '@modelcontextprotocol/sdk/server/auth/types.js';
|
|
6
|
+
|
|
7
|
+
interface McpFnTestClientOptions {
|
|
8
|
+
capabilities?: ClientCapabilities;
|
|
9
|
+
/** Install roots, sampling, elicitation, or notification handlers before initialize. */
|
|
10
|
+
configure?(client: Client): void | Promise<void>;
|
|
11
|
+
}
|
|
12
|
+
declare class McpFnTestClient<TContext = undefined> {
|
|
13
|
+
readonly client: Client;
|
|
14
|
+
private readonly server;
|
|
15
|
+
private closed;
|
|
16
|
+
private constructor();
|
|
17
|
+
static connect<TContext>(server: McpFnServer<TContext>, info?: {
|
|
18
|
+
name: string;
|
|
19
|
+
version: string;
|
|
20
|
+
}, options?: McpFnTestClientOptions): Promise<McpFnTestClient<TContext>>;
|
|
21
|
+
listTools(): Promise<Tool[]>;
|
|
22
|
+
callTool(name: string, args?: Record<string, unknown>): Promise<CallToolResult>;
|
|
23
|
+
createToolTask(name: string, args?: Record<string, unknown>, options?: {
|
|
24
|
+
ttl?: number;
|
|
25
|
+
}): Promise<CreateTaskResult>;
|
|
26
|
+
getTask(taskId: string): Promise<Task>;
|
|
27
|
+
getTaskResult(taskId: string): Promise<CallToolResult>;
|
|
28
|
+
listTasks(cursor?: string): Promise<ListTasksResult>;
|
|
29
|
+
cancelTask(taskId: string): Promise<Task>;
|
|
30
|
+
listResources(): Promise<Resource[]>;
|
|
31
|
+
listResourceTemplates(): Promise<ResourceTemplate[]>;
|
|
32
|
+
readResource(uri: string): Promise<ReadResourceResult>;
|
|
33
|
+
subscribeResource(uri: string): Promise<void>;
|
|
34
|
+
unsubscribeResource(uri: string): Promise<void>;
|
|
35
|
+
listPrompts(): Promise<Prompt[]>;
|
|
36
|
+
getPrompt(name: string, args?: Record<string, string>): Promise<GetPromptResult>;
|
|
37
|
+
complete(params: CompleteRequest["params"]): Promise<CompleteResult>;
|
|
38
|
+
close(): Promise<void>;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
declare function stableJson(value: unknown): string;
|
|
42
|
+
declare class McpFnAssertionError extends Error {
|
|
43
|
+
constructor(message: string);
|
|
44
|
+
}
|
|
45
|
+
interface AssertManifestContractOptions {
|
|
46
|
+
/** Exact tools expected to be visible for the test client's request context. */
|
|
47
|
+
expectedToolNames?: readonly string[];
|
|
48
|
+
}
|
|
49
|
+
declare function assertManifestContract(client: McpFnTestClient<unknown>, manifest: McpFnManifest, options?: AssertManifestContractOptions): Promise<Tool[]>;
|
|
50
|
+
declare function assertStructuredTextParity(result: {
|
|
51
|
+
content?: unknown[];
|
|
52
|
+
structuredContent?: Record<string, unknown>;
|
|
53
|
+
}): void;
|
|
54
|
+
|
|
55
|
+
declare const OFFICIAL_CONFORMANCE_VERSION = "0.1.16";
|
|
56
|
+
interface OfficialConformanceOptions {
|
|
57
|
+
url: string;
|
|
58
|
+
suite?: "active" | "all" | "pending";
|
|
59
|
+
scenario?: string;
|
|
60
|
+
expectedFailures?: string;
|
|
61
|
+
outputDir?: string;
|
|
62
|
+
specVersion?: string;
|
|
63
|
+
verbose?: boolean;
|
|
64
|
+
cwd?: string;
|
|
65
|
+
stdio?: "inherit" | "pipe";
|
|
66
|
+
}
|
|
67
|
+
interface OfficialConformanceResult {
|
|
68
|
+
exitCode: number;
|
|
69
|
+
stdout: string;
|
|
70
|
+
stderr: string;
|
|
71
|
+
}
|
|
72
|
+
declare function buildOfficialConformanceArgs(options: OfficialConformanceOptions): string[];
|
|
73
|
+
declare function runOfficialConformance(options: OfficialConformanceOptions): Promise<OfficialConformanceResult>;
|
|
74
|
+
|
|
75
|
+
type McpFnServerFeature = "tools" | "resources" | "prompts" | "completions" | "tasks" | "logging";
|
|
76
|
+
interface McpFnHostProfile {
|
|
77
|
+
id: string;
|
|
78
|
+
name: string;
|
|
79
|
+
protocolVersions: string[];
|
|
80
|
+
serverFeatures: McpFnServerFeature[];
|
|
81
|
+
clientFeatures?: {
|
|
82
|
+
sampling?: boolean;
|
|
83
|
+
elicitation?: Array<"form" | "url">;
|
|
84
|
+
roots?: boolean;
|
|
85
|
+
};
|
|
86
|
+
extensions?: string[];
|
|
87
|
+
}
|
|
88
|
+
interface McpFnHostCompatibilityIssue {
|
|
89
|
+
severity: "incompatible" | "degraded";
|
|
90
|
+
code: string;
|
|
91
|
+
path: string;
|
|
92
|
+
message: string;
|
|
93
|
+
}
|
|
94
|
+
interface McpFnHostCompatibilityResult {
|
|
95
|
+
status: "compatible" | "degraded" | "incompatible";
|
|
96
|
+
compatible: boolean;
|
|
97
|
+
issues: McpFnHostCompatibilityIssue[];
|
|
98
|
+
}
|
|
99
|
+
declare const MCPFN_HOST_PROFILES: {
|
|
100
|
+
readonly toolsOnly: {
|
|
101
|
+
readonly id: "mcpfn/tools-only";
|
|
102
|
+
readonly name: "Tools-only MCP host";
|
|
103
|
+
readonly protocolVersions: ["2025-03-26", "2025-06-18", "2025-11-25"];
|
|
104
|
+
readonly serverFeatures: ["tools"];
|
|
105
|
+
};
|
|
106
|
+
readonly fullProtocol: {
|
|
107
|
+
readonly id: "mcpfn/full-protocol";
|
|
108
|
+
readonly name: "Full protocol MCP host";
|
|
109
|
+
readonly protocolVersions: ["2025-03-26", "2025-06-18", "2025-11-25"];
|
|
110
|
+
readonly serverFeatures: ["tools", "resources", "prompts", "completions", "tasks", "logging"];
|
|
111
|
+
readonly clientFeatures: {
|
|
112
|
+
readonly sampling: true;
|
|
113
|
+
readonly elicitation: ["form", "url"];
|
|
114
|
+
readonly roots: true;
|
|
115
|
+
};
|
|
116
|
+
};
|
|
117
|
+
readonly mcpApps: {
|
|
118
|
+
readonly id: "mcpfn/mcp-apps";
|
|
119
|
+
readonly name: "Full protocol host with MCP Apps";
|
|
120
|
+
readonly protocolVersions: ["2025-11-25"];
|
|
121
|
+
readonly serverFeatures: ["tools", "resources", "prompts", "completions", "tasks", "logging"];
|
|
122
|
+
readonly clientFeatures: {
|
|
123
|
+
readonly sampling: true;
|
|
124
|
+
readonly elicitation: ["form", "url"];
|
|
125
|
+
readonly roots: true;
|
|
126
|
+
};
|
|
127
|
+
readonly extensions: ["io.modelcontextprotocol/ui"];
|
|
128
|
+
};
|
|
129
|
+
};
|
|
130
|
+
declare function checkHostCompatibility(manifest: McpFnManifest, profile: McpFnHostProfile): McpFnHostCompatibilityResult;
|
|
131
|
+
|
|
132
|
+
interface McpFnScenario {
|
|
133
|
+
name: string;
|
|
134
|
+
tool: string;
|
|
135
|
+
arguments?: Record<string, unknown>;
|
|
136
|
+
expect?: {
|
|
137
|
+
isError?: boolean;
|
|
138
|
+
structuredContent?: unknown;
|
|
139
|
+
structuredTextParity?: boolean;
|
|
140
|
+
};
|
|
141
|
+
verify?(result: CallToolResult): void | Promise<void>;
|
|
142
|
+
}
|
|
143
|
+
interface McpFnScenarioResult {
|
|
144
|
+
name: string;
|
|
145
|
+
tool: string;
|
|
146
|
+
status: "passed" | "failed";
|
|
147
|
+
durationMs: number;
|
|
148
|
+
error?: string;
|
|
149
|
+
}
|
|
150
|
+
declare function runScenarios(client: McpFnTestClient<unknown>, scenarios: McpFnScenario[]): Promise<McpFnScenarioResult[]>;
|
|
151
|
+
|
|
152
|
+
export { type AssertManifestContractOptions, MCPFN_HOST_PROFILES, McpFnAssertionError, type McpFnHostCompatibilityIssue, type McpFnHostCompatibilityResult, type McpFnHostProfile, type McpFnScenario, type McpFnScenarioResult, type McpFnServerFeature, McpFnTestClient, type McpFnTestClientOptions, OFFICIAL_CONFORMANCE_VERSION, type OfficialConformanceOptions, type OfficialConformanceResult, assertManifestContract, assertStructuredTextParity, buildOfficialConformanceArgs, checkHostCompatibility, runOfficialConformance, runScenarios, stableJson };
|