@smartbear/mcp 0.12.0 → 0.13.1

package/dist/common/transport-stdio.js

@@ -2,47 +2,50 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { clientRegistry } from "./client-registry.js";
 import { MCP_SERVER_NAME, MCP_SERVER_VERSION } from "./info.js";
 import { SmartBearMcpServer } from "./server.js";
-/**
- * Generate a dynamic error message listing all available clients and their required env vars
- */
-function getNoConfigErrorMessage() {
-    const messages = [];
-    for (const entry of clientRegistry.getAll()) {
-        messages.push(` - ${entry.name}:`);
-        for (const [configKey, requirement] of Object.entries(entry.config.shape)) {
-            const envVarName = getEnvVarName(entry, configKey);
-            const requiredTag = requirement.isOptional()
-                ? " (optional)"
-                : " (required)";
-            messages.push(`    - ${envVarName}${requiredTag}: ${requirement.description}`);
-        }
+import { isOptionalType } from "./zod-utils.js";
+function getNoConfigMessage() {
+  const messages = [];
+  for (const entry of clientRegistry.getAll()) {
+    messages.push(` - ${entry.name}:`);
+    for (const [configKey, requirement] of Object.entries(entry.config.shape)) {
+      const envVarName = getEnvVarName(entry, configKey);
+      const requiredTag = isOptionalType(requirement) ? " (optional)" : " (required)";
+      messages.push(
+        `    - ${envVarName}${requiredTag}: ${requirement.description}`
+      );
     }
-    return messages;
+  }
+  return messages;
 }
-/**
- * Run server in STDIO mode (default)
- */
-export async function runStdioMode() {
-    if (process.argv.includes("--version")) {
-        console.log(`${MCP_SERVER_NAME}: v${MCP_SERVER_VERSION}`);
-        process.exit(0);
+async function runStdioMode() {
+  if (process.argv.includes("--version")) {
+    console.log(`${MCP_SERVER_NAME}: v${MCP_SERVER_VERSION}`);
+    process.exit(0);
+  }
+  const server = new SmartBearMcpServer();
+  const configuredCount = await clientRegistry.configure(
+    server,
+    (client, key) => {
+      const envVarName = getEnvVarName(client, key);
+      return process.env[envVarName] || null;
     }
-    const server = new SmartBearMcpServer();
-    // Setup clients from environment variables
-    const configuredCount = await clientRegistry.configure(server, (client, key) => {
-        const envVarName = getEnvVarName(client, key);
-        return process.env[envVarName] || null;
-    });
-    if (configuredCount === 0) {
-        const errorMessage = getNoConfigErrorMessage();
-        console.error(errorMessage.length > 0
-            ? `No clients configured. Please provide valid environment variables for at least one client:\n${errorMessage.join("\n")}`
-            : "No clients support environment variable configuration.");
-        process.exit(1);
+  );
+  if (configuredCount === 0) {
+    const message = getNoConfigMessage();
+    console.warn(
+      message.length > 0 ? `No clients configured. Please provide valid environment variables for at least one client:
+${message.join("\n")}` : "No clients support environment variable configuration."
+    );
+    for (const entry of clientRegistry.getAll()) {
+      await server.addClient(entry);
     }
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
+  }
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
 }
 function getEnvVarName(client, key) {
-    return `${client.configPrefix.toUpperCase().replace(/-/g, "_")}_${key.toUpperCase()}`;
+  return `${client.configPrefix.toUpperCase().replace(/-/g, "_")}_${key.toUpperCase()}`;
 }
+export {
+  runStdioMode
+};

package/dist/common/zod-utils.js

@@ -0,0 +1,20 @@
+import { ZodOptional, ZodDefault, ZodNullable } from "zod";
+function isOptionalType(zodType) {
+  return zodType instanceof ZodOptional || zodType instanceof ZodDefault || zodType instanceof ZodNullable;
+}
+function unwrapZodType(zodType) {
+  if (zodType instanceof ZodOptional) {
+    return unwrapZodType(zodType.unwrap());
+  }
+  if (zodType instanceof ZodDefault) {
+    return unwrapZodType(zodType.unwrap());
+  }
+  if (zodType instanceof ZodNullable) {
+    return unwrapZodType(zodType.unwrap());
+  }
+  return zodType;
+}
+export {
+  isOptionalType,
+  unwrapZodType
+};

package/dist/index.js

@@ -1,34 +1,29 @@
 #!/usr/bin/env node
 import Bugsnag from "./common/bugsnag.js";
-import "./common/register-clients.js"; // Register all available clients
+import "./common/register-clients.js";
 import { runHttpMode } from "./common/transport-http.js";
 import { runStdioMode } from "./common/transport-stdio.js";
-// This is used to report errors in the MCP server itself
-// If you want to use your own BugSnag API key, set the MCP_SERVER_BUGSNAG_API_KEY environment variable
 const McpServerBugsnagAPIKey = process.env.MCP_SERVER_BUGSNAG_API_KEY;
 if (McpServerBugsnagAPIKey) {
-    Bugsnag.start(McpServerBugsnagAPIKey);
+  Bugsnag.start(McpServerBugsnagAPIKey);
 }
 async function main() {
-    // Determine transport mode from environment variable
-    // MCP_TRANSPORT can be "stdio" (default) or "http"
-    const transportMode = process.env.MCP_TRANSPORT?.toLowerCase() || "stdio";
-    if (transportMode === "http") {
-        console.log("[MCP] Starting in HTTP mode...");
-        await runHttpMode();
-    }
-    else if (transportMode === "stdio") {
-        await runStdioMode();
-    }
-    else {
-        console.error(`[MCP] Invalid transport mode: ${transportMode}. Use "stdio" or "http".`);
-        process.exit(1);
-    }
+  const transportMode = process.env.MCP_TRANSPORT?.toLowerCase() || "stdio";
+  if (transportMode === "http") {
+    console.log("[MCP] Starting in HTTP mode...");
+    await runHttpMode();
+  } else if (transportMode === "stdio") {
+    await runStdioMode();
+  } else {
+    console.error(
+      `[MCP] Invalid transport mode: ${transportMode}. Use "stdio" or "http".`
+    );
+    process.exit(1);
+  }
 }
 try {
-    await main();
-}
-catch (error) {
-    console.error("Fatal error in main():", error);
-    process.exit(1);
+  await main();
+} catch (error) {
+  console.error("Fatal error in main():", error);
+  process.exit(1);
 }

package/dist/package.json.js

@@ -0,0 +1,11 @@
+const version = "0.13.1";
+const config = { "mcpServerName": "SmartBear MCP Server" };
+const packageJson = {
+  version,
+  config
+};
+export {
+  config,
+  packageJson as default,
+  version
+};

package/dist/pactflow/client/ai.js

@@ -1,177 +1,150 @@
 import { z } from "zod";
 import { addOpenAPISpecToSchema } from "./utils.js";
-// Type definitions for PactFlow AI API
-export const GenerationLanguages = [
-    "javascript",
-    "typescript",
-    "java",
-    "golang",
-    "dotnet",
-    "kotlin",
-    "swift",
-    "php",
+const GenerationLanguages = [
+  "javascript",
+  "typescript",
+  "java",
+  "golang",
+  "dotnet",
+  "kotlin",
+  "swift",
+  "php"
 ];
-export const HttpMethods = [
-    "GET",
-    "PUT",
-    "POST",
-    "DELETE",
-    "OPTIONS",
-    "HEAD",
-    "PATCH",
-    "TRACE",
+const HttpMethods = [
+  "GET",
+  "PUT",
+  "POST",
+  "DELETE",
+  "OPTIONS",
+  "HEAD",
+  "PATCH",
+  "TRACE"
 ];
-// zod schemas
-export const FileInputSchema = z.object({
-    filename: z
-        .string()
-        .optional()
-        .describe("Filename (helps identify file type and context)"),
-    language: z
-        .string()
-        .optional()
-        .describe("Programming language (e.g., 'javascript', 'java', 'python') for better analysis"),
-    body: z
-        .string()
-        .describe("Complete file contents - client code, models, test files, etc."),
+const FileInputSchema = z.object({
+  filename: z.string().optional().describe("Filename (helps identify file type and context)"),
+  language: z.string().optional().describe(
+    "Programming language (e.g., 'javascript', 'java', 'python') for better analysis"
+  ),
+  body: z.string().describe("Complete file contents - client code, models, test files, etc.")
 });
-export const OpenAPISchema = z
-    .object({
-    openapi: z
-        .string()
-        .optional()
-        .describe("For OpenAPI version (e.g., '3.0.0')"),
-    swagger: z
-        .string()
-        .describe("For OpenAPI documents version 2.x (e.g., '2.0')")
-        .optional(),
-    paths: z
-        .record(z.string(), z.record(z.string(), z.any()))
-        .describe("OpenAPI paths object containing all API endpoints"),
-    components: z
-        .record(z.string(), z.record(z.string(), z.any()))
-        .optional()
-        .describe("OpenAPI components section (schemas, responses, etc.)"),
-})
-    .passthrough()
-    .describe("The complete OpenAPI document describing the API.")
-    .refine((data) => data.openapi || data.swagger, {
-    message: "Either 'openapi' (for v3+) or 'swagger' (for v2) must be provided",
-    path: ["openapi"],
+const OpenAPISchema = z.object({
+  openapi: z.string().optional().describe("For OpenAPI version (e.g., '3.0.0')"),
+  swagger: z.string().describe("For OpenAPI documents version 2.x (e.g., '2.0')").optional(),
+  paths: z.record(z.string(), z.record(z.string(), z.any())).describe("OpenAPI paths object containing all API endpoints"),
+  components: z.record(z.string(), z.record(z.string(), z.any())).optional().describe("OpenAPI components section (schemas, responses, etc.)")
+}).passthrough().describe("The complete OpenAPI document describing the API.").refine((data) => data.openapi || data.swagger, {
+  message: "Either 'openapi' (for v3+) or 'swagger' (for v2) must be provided",
+  path: ["openapi"]
 });
-export const EndpointMatcherSchema = z
-    .object({
-    path: z
-        .string()
-        .optional()
-        .describe("Path pattern to match specific endpoints (e.g., '/users/{id}', '/users/*', '/users/**'). Supports glob patterns: ? (single char), * (excluding /), ** (including /)"),
-    methods: z
-        .array(z.enum(HttpMethods))
-        .optional()
-        .describe("HTTP methods to include (e.g., ['GET', 'POST']). If not specified, all methods are matched"),
-    statusCodes: z
-        .array(z.union([z.number(), z.string()]))
-        .optional()
-        .describe("Response status codes to include (e.g., [200, '2XX', 404]). Use 'X' as wildcard (e.g., '2XX' for 200-299). Defaults to successful codes (2XX)"),
-    operationId: z
-        .string()
-        .optional()
-        .describe("OpenAPI operation ID to match (e.g., 'getUserById', 'get*'). Supports glob patterns"),
-})
-    .optional()
-    .describe("REQUIRED: Matcher to specify which endpoints from the OpenAPI document to generate tests for. At least one matcher field must be provided");
-export const RemoteOpenAPIDocumentSchema = z
-    .object({
-    authToken: z
-        .string()
-        .describe("Auth Bearer Token if the OpenAPI spec requires authentication.")
-        .optional(),
-    authScheme: z
-        .string()
-        .describe("Authentication scheme (e.g., 'Bearer', 'Basic'). Default scheme passed should be Bearer if authToken is specified and this field is not set.")
-        .default("Bearer")
-        .optional(),
-    url: z
-        .string()
-        .url("Must be a valid openapi url")
-        .describe("URL of the remote OpenAPI document.")
-        .optional(),
-})
-    .describe("Use this schema to fetch openapi documents present over a url.");
-export const OpenAPIWithMatcherSchema = z
-    .object({
-    document: OpenAPISchema.describe("The OpenAPI document describing the API being tested. if document is not provided, don't add the field if remoteOpenAPIDocument is provided.").optional(),
-    matcher: EndpointMatcherSchema,
-    remoteDocument: RemoteOpenAPIDocumentSchema.optional().describe("The remote OpenAPI document to use for the review/generation in case openapi document is not provided. If provided do not include the document field under openapi."),
-})
-    .describe("If provided, the OpenAPI document which describes the API being tested and is accompanied by a matcher which will be used to identify the interactions in the OpenAPI document which are relevant to the Pact refinement process.")
-    .transform(addOpenAPISpecToSchema);
-export const RefineInputSchema = z.object({
-    pactTests: FileInputSchema.describe("Primary pact tests that needs to be refined."),
-    code: z
-        .array(FileInputSchema)
-        .describe("Collection of source code files to analyze and extract API interactions from. Include client code, data models, existing tests, or any code that makes API calls")
-        .optional(),
-    userInstructions: z
-        .string()
-        .describe("Optional free-form instructions that provide additional context or specify areas of focus during the refinement process of the Pact test.")
-        .optional(),
-    errorMessages: z
-        .array(z.string())
-        .describe("Optional error output from failed contract test runs. These can be used to better understand the context or failures observed and guide the recommendations toward resolving specific issues.")
-        .optional(),
-    openapi: OpenAPIWithMatcherSchema.optional(),
+const EndpointMatcherSchema = z.object({
+  path: z.string().optional().describe(
+    "Path pattern to match specific endpoints (e.g., '/users/{id}', '/users/*', '/users/**'). Supports glob patterns: ? (single char), * (excluding /), ** (including /)"
+  ),
+  methods: z.array(z.enum(HttpMethods)).optional().describe(
+    "HTTP methods to include (e.g., ['GET', 'POST']). If not specified, all methods are matched"
+  ),
+  statusCodes: z.array(z.union([z.number(), z.string()])).optional().describe(
+    "Response status codes to include (e.g., [200, '2XX', 404]). Use 'X' as wildcard (e.g., '2XX' for 200-299). Defaults to successful codes (2XX)"
+  ),
+  operationId: z.string().optional().describe(
+    "OpenAPI operation ID to match (e.g., 'getUserById', 'get*'). Supports glob patterns"
+  )
+}).optional().describe(
+  "REQUIRED: Matcher to specify which endpoints from the OpenAPI document to generate tests for. At least one matcher field must be provided"
+);
+const RemoteOpenAPIDocumentSchema = z.object({
+  authToken: z.string().describe(
+    "Auth Bearer Token if the OpenAPI spec requires authentication."
+  ).optional(),
+  authScheme: z.string().describe(
+    "Authentication scheme (e.g., 'Bearer', 'Basic'). Default scheme passed should be Bearer if authToken is specified and this field is not set."
+  ).default("Bearer").optional(),
+  url: z.string().url("Must be a valid openapi url").describe("URL of the remote OpenAPI document.").optional()
+}).describe("Use this schema to fetch openapi documents present over a url.");
+const OpenAPIWithMatcherSchema = z.object({
+  document: OpenAPISchema.describe(
+    "The OpenAPI document describing the API being tested. if document is not provided, don't add the field if remoteOpenAPIDocument is provided."
+  ).optional(),
+  matcher: EndpointMatcherSchema,
+  remoteDocument: RemoteOpenAPIDocumentSchema.optional().describe(
+    "The remote OpenAPI document to use for the review/generation in case openapi document is not provided. If provided do not include the document field under openapi."
+  )
+}).describe(
+  "If provided, the OpenAPI document which describes the API being tested and is accompanied by a matcher which will be used to identify the interactions in the OpenAPI document which are relevant to the Pact refinement process."
+).transform(addOpenAPISpecToSchema);
+const RefineInputSchema = z.object({
+  pactTests: FileInputSchema.describe(
+    "Primary pact tests that needs to be refined."
+  ),
+  code: z.array(FileInputSchema).describe(
+    "Collection of source code files to analyze and extract API interactions from. Include client code, data models, existing tests, or any code that makes API calls"
+  ).optional(),
+  userInstructions: z.string().describe(
+    "Optional free-form instructions that provide additional context or specify areas of focus during the refinement process of the Pact test."
+  ).optional(),
+  errorMessages: z.array(z.string()).describe(
+    "Optional error output from failed contract test runs. These can be used to better understand the context or failures observed and guide the recommendations toward resolving specific issues."
+  ).optional(),
+  openapi: OpenAPIWithMatcherSchema.optional()
 });
-export const RequestResponsePairSchema = z
-    .object({
-    request: FileInputSchema,
-    response: FileInputSchema,
-})
-    .describe("Direct request/response pair for a specific interaction. Use this when you have concrete examples of API requests and responses");
-export const GenerationInputSchema = z.object({
-    language: z
-        .enum(GenerationLanguages)
-        .optional()
-        .describe("Target language for the generated Pact tests. If not provided, will be inferred from other inputs."),
-    requestResponse: RequestResponsePairSchema.optional(),
-    code: z
-        .array(FileInputSchema)
-        .optional()
-        .describe("Collection of source code files to analyze and extract API interactions from. Include client code, data models, existing tests, or any code that makes API calls"),
-    openapi: OpenAPIWithMatcherSchema.optional(),
-    additionalInstructions: z
-        .string()
-        .optional()
-        .describe("Optional free-form instructions to guide the generation process (e.g., 'Focus on error scenarios', 'Include authentication headers', 'Use specific test framework patterns')"),
-    testTemplate: FileInputSchema.optional().describe("Optional test template to use as a basis for generation. Helps ensure generated tests follow your specific patterns, frameworks, and coding standards"),
+const RequestResponsePairSchema = z.object({
+  request: FileInputSchema,
+  response: FileInputSchema
+}).describe(
+  "Direct request/response pair for a specific interaction. Use this when you have concrete examples of API requests and responses"
+);
+const GenerationInputSchema = z.object({
+  language: z.enum(GenerationLanguages).optional().describe(
+    "Target language for the generated Pact tests. If not provided, will be inferred from other inputs."
+  ),
+  requestResponse: RequestResponsePairSchema.optional(),
+  code: z.array(FileInputSchema).optional().describe(
+    "Collection of source code files to analyze and extract API interactions from. Include client code, data models, existing tests, or any code that makes API calls"
+  ),
+  openapi: OpenAPIWithMatcherSchema.optional(),
+  additionalInstructions: z.string().optional().describe(
+    "Optional free-form instructions to guide the generation process (e.g., 'Focus on error scenarios', 'Include authentication headers', 'Use specific test framework patterns')"
+  ),
+  testTemplate: FileInputSchema.optional().describe(
+    "Optional test template to use as a basis for generation. Helps ensure generated tests follow your specific patterns, frameworks, and coding standards"
+  )
 });
-export const MatcherRecommendationInputSchema = z.array(EndpointMatcherSchema);
-export const AiCreditsSchema = z
-    .object({
-    total: z.number().describe("The total number of AI credits available."),
-    used: z.number().describe("The number of AI credits used."),
-})
-    .describe("AI credits information.");
-export const OrganizationEntitlementsSchema = z
-    .object({
-    name: z.string().describe("The name of the organization."),
-    planAiEnabled: z
-        .boolean()
-        .describe("Whether AI features are enabled at the plan level."),
-    preferencesAiEnabled: z
-        .boolean()
-        .describe("Whether AI features are enabled at the preferences level."),
-    aiCredits: AiCreditsSchema.describe("AI credits information."),
-})
-    .describe("Organization entitlements information.");
-export const UserEntitlementsSchema = z
-    .object({
-    aiPermissions: z.array(z.string()).describe("List of AI permissions."),
-})
-    .describe("User entitlements information.");
-export const EntitlementsSchema = z
-    .object({
-    organizationEntitlements: OrganizationEntitlementsSchema.describe("Organization entitlements information."),
-    userEntitlements: UserEntitlementsSchema.describe("User entitlements information."),
-})
-    .describe("Entitlements information.");
+const MatcherRecommendationInputSchema = z.array(EndpointMatcherSchema);
+const AiCreditsSchema = z.object({
+  total: z.number().describe("The total number of AI credits available."),
+  used: z.number().describe("The number of AI credits used.")
+}).describe("AI credits information.");
+const OrganizationEntitlementsSchema = z.object({
+  name: z.string().describe("The name of the organization."),
+  planAiEnabled: z.boolean().describe("Whether AI features are enabled at the plan level."),
+  preferencesAiEnabled: z.boolean().describe("Whether AI features are enabled at the preferences level."),
+  aiCredits: AiCreditsSchema.describe("AI credits information.")
+}).describe("Organization entitlements information.");
+const UserEntitlementsSchema = z.object({
+  aiPermissions: z.array(z.string()).describe("List of AI permissions.")
+}).describe("User entitlements information.");
+z.object({
+  organizationEntitlements: OrganizationEntitlementsSchema.describe(
+    "Organization entitlements information."
+  ),
+  userEntitlements: UserEntitlementsSchema.describe(
+    "User entitlements information."
+  ),
+  aiEnabled: z.boolean()
+}).describe("Entitlements information.");
+export {
+  AiCreditsSchema,
+  EndpointMatcherSchema,
+  FileInputSchema,
+  GenerationInputSchema,
+  GenerationLanguages,
+  HttpMethods,
+  MatcherRecommendationInputSchema,
+  OpenAPISchema,
+  OpenAPIWithMatcherSchema,
+  OrganizationEntitlementsSchema,
+  RefineInputSchema,
+  RemoteOpenAPIDocumentSchema,
+  RequestResponsePairSchema,
+  UserEntitlementsSchema
+};

package/dist/pactflow/client/base.js

@@ -1,54 +1,44 @@
 import { z } from "zod";
-export const CanIDeploySchema = z.object({
-    pacticipant: z
-        .string()
-        .describe("The name of the pacticipant (application/service) being evaluated for deployment"),
-    version: z
-        .string()
-        .describe("The version of the pacticipant that you want to check if it's safe to deploy"),
-    environment: z
-        .string()
-        .describe("The target environment where the pacticipant version will be deployed (e.g., 'production', 'staging', 'test')"),
+const CanIDeploySchema = z.object({
+  pacticipant: z.string().describe(
+    "The name of the pacticipant (application/service) being evaluated for deployment"
+  ),
+  version: z.string().describe(
+    "The version of the pacticipant that you want to check if it's safe to deploy"
+  ),
+  environment: z.string().describe(
+    "The target environment where the pacticipant version will be deployed (e.g., 'production', 'staging', 'test')"
+  )
 });
-export const MatrixSchema = z.object({
-    latestby: z
-        .string()
-        .optional()
-        .describe("This property removes the rows for the overridden pacts/verifications from the results. The options are cvp (show only the latest row for each consumer version and provider) and cvpv (show only the latest row each consumer version and provider version). For a can-i-deploy query with one selector, it should be set to cvp. For a can-i-deploy query with two selectors, it should be set to cvpv."),
-    limit: z
-        .number()
-        .min(1)
-        .max(1000)
-        .default(100)
-        .optional()
-        .describe("The limit on the number of results to return (1-1000, default: 100)"),
-    q: z
-        .array(z.object({
-        pacticipant: z
-            .string()
-            .describe("Name of the pacticipant (application)"),
-        version: z.string().optional().describe("Version number"),
-        branch: z
-            .string()
-            .optional()
-            .describe("Name of the pacticipant version branch"),
-        environment: z
-            .string()
-            .optional()
-            .describe("The name of the environment that the pacticipant version is deployed to"),
-        latest: z
-            .boolean()
-            .optional()
-            .describe("Used in conjunction with other properties to indicate whether the selector is describing the latest version from a branch/with a tag/for a pacticipant, or all of them. Note that when used with tags, the 'latest' is calculated using the creation date of the pacticipant version, NOT the creation date of the tag."),
-        tag: z
-            .string()
-            .optional()
-            .describe("The name of the pacticipant version tag (superseded by branch and environments)"),
-        mainBranch: z
-            .boolean()
-            .optional()
-            .describe("Whether or not the version(s) described are from the main branch of the pacticipant, as set in the mainBranch property of the pacticipant resource."),
-    }))
-        .min(1)
-        .max(2),
+const MatrixSchema = z.object({
+  latestby: z.string().optional().describe(
+    "This property removes the rows for the overridden pacts/verifications from the results. The options are cvp (show only the latest row for each consumer version and provider) and cvpv (show only the latest row each consumer version and provider version). For a can-i-deploy query with one selector, it should be set to cvp. For a can-i-deploy query with two selectors, it should be set to cvpv."
+  ),
+  limit: z.number().min(1).max(1e3).default(100).optional().describe(
+    "The limit on the number of results to return (1-1000, default: 100)"
+  ),
+  q: z.array(
+    z.object({
+      pacticipant: z.string().describe("Name of the pacticipant (application)"),
+      version: z.string().optional().describe("Version number"),
+      branch: z.string().optional().describe("Name of the pacticipant version branch"),
+      environment: z.string().optional().describe(
+        "The name of the environment that the pacticipant version is deployed to"
+      ),
+      latest: z.boolean().optional().describe(
+        "Used in conjunction with other properties to indicate whether the selector is describing the latest version from a branch/with a tag/for a pacticipant, or all of them. Note that when used with tags, the 'latest' is calculated using the creation date of the pacticipant version, NOT the creation date of the tag."
+      ),
+      tag: z.string().optional().describe(
+        "The name of the pacticipant version tag (superseded by branch and environments)"
+      ),
+      mainBranch: z.boolean().optional().describe(
+        "Whether or not the version(s) described are from the main branch of the pacticipant, as set in the mainBranch property of the pacticipant resource."
+      )
+    })
+  ).min(1).max(2)
 });
+z.object({});
+export {
+  CanIDeploySchema,
+  MatrixSchema
+};