@smartbear/mcp 0.17.0 → 0.17.1

package/dist/package.json.js

@@ -1,4 +1,4 @@
-const version = "0.17.0";
+const version = "0.17.1";
 const config = { "mcpServerName": "SmartBear MCP Server" };
 const packageJson = {
   version,

package/dist/pactflow/client/base.js

@@ -37,8 +37,439 @@ const MatrixSchema = z.object({
     })
   ).min(1).max(2)
 });
-z.object({});
+const GetPacticipantSchema = z.object({
+  pacticipantName: z.string().describe("Name of the pacticipant (application or service)")
+});
+const ListBranchesSchema = z.object({
+  pacticipantName: z.string().describe("Name of the pacticipant"),
+  q: z.string().optional().describe("Filter branches by name"),
+  pageNumber: z.number().optional().describe("Page number (default: 1)"),
+  pageSize: z.number().optional().describe("Results per page (default: 100)")
+});
+const ListVersionsSchema = z.object({
+  pacticipantName: z.string().describe("Name of the pacticipant"),
+  pageNumber: z.number().optional().describe("Page number"),
+  pageSize: z.number().optional().describe("Results per page")
+});
+const GetVersionSchema = z.object({
+  pacticipantName: z.string().describe("Name of the pacticipant"),
+  versionNumber: z.string().describe("Version number to retrieve")
+});
+const GetLatestVersionSchema = z.object({
+  pacticipantName: z.string().describe("Name of the pacticipant"),
+  tag: z.string().optional().describe(
+    "Tag to filter by. If omitted, returns the overall latest version."
+  )
+});
+const GetEnvironmentSchema = z.object({
+  environmentId: z.string().describe("UUID of the environment")
+});
+const RecordDeploymentSchema = z.object({
+  pacticipantName: z.string().describe("Name of the pacticipant that was deployed"),
+  versionNumber: z.string().describe("Version number that was deployed"),
+  environmentId: z.string().describe("UUID of the target environment"),
+  applicationInstance: z.string().optional().describe(
+    "Identifies a specific instance when multiple instances of the same application are deployed to the same environment (e.g. 'blue', 'green')"
+  )
+});
+const GetCurrentlyDeployedSchema = z.object({
+  environmentId: z.string().describe("UUID of the environment")
+});
+const RecordReleaseSchema = z.object({
+  pacticipantName: z.string().describe("Name of the pacticipant that was released"),
+  versionNumber: z.string().describe("Version number that was released"),
+  environmentId: z.string().describe("UUID of the target environment")
+});
+const GetCurrentlySupportedSchema = z.object({
+  environmentId: z.string().describe("UUID of the environment")
+});
+const PublishConsumerContractsSchema = z.object({
+  pacticipantName: z.string().min(1).describe("Name of the consumer application"),
+  pacticipantVersionNumber: z.string().min(1).describe("Version number of the consumer"),
+  contracts: z.array(
+    z.object({
+      consumerName: z.string().describe("Consumer application name"),
+      providerName: z.string().describe("Provider application name"),
+      content: z.string().describe("Base64-encoded Pact JSON content"),
+      contentType: z.literal("application/json").describe("Content type (must be 'application/json')"),
+      specification: z.literal("pact").describe("Specification type (must be 'pact')")
+    })
+  ).describe("Contracts to publish"),
+  tags: z.array(z.string()).optional().describe("Version tags (e.g. 'main', 'staging')"),
+  branch: z.string().optional().describe("Branch name of the consumer"),
+  buildUrl: z.string().optional().describe("URL of the CI build that produced these contracts")
+});
+const PublishProviderContractSchema = z.object({
+  providerName: z.string().describe("Name of the provider application"),
+  pacticipantVersionNumber: z.string().min(1).describe("Version number of the provider"),
+  contract: z.object({
+    content: z.string().describe("Base64-encoded OpenAPI specification content"),
+    contentType: z.enum(["application/json", "application/yaml", "application/yml"]).describe("Content type of the OpenAPI spec"),
+    specification: z.literal("oas").describe("Specification type (must be 'oas')"),
+    selfVerificationResults: z.object({
+      success: z.boolean().describe("Whether self-verification passed"),
+      content: z.string().optional().describe("Verification results content (e.g. test output)"),
+      contentType: z.string().optional().describe("Content type of the verification results"),
+      verifier: z.string().describe(
+        "Name of the tool used for verification (e.g. 'dredd', 'schemathesis')"
+      ),
+      verifierVersion: z.string().optional().describe("Version of the verification tool"),
+      format: z.string().optional().describe("Format of the verification results")
+    }).describe(
+      "Results of self-verifying the provider against its own contract"
+    )
+  }).describe("Provider contract (OpenAPI spec) and verification details"),
+  tags: z.array(z.string()).optional().describe("Version tags"),
+  branch: z.string().optional().describe("Branch name of the provider"),
+  buildUrl: z.string().optional().describe("URL of the CI build")
+});
+const GetPactsForVerificationSchema = z.object({
+  providerName: z.string().describe("Name of the provider to get pacts for"),
+  consumerVersionSelectors: z.array(
+    z.object({
+      branch: z.string().optional().describe("Consumer branch name"),
+      consumer: z.string().optional().describe("Consumer name"),
+      deployed: z.boolean().optional().describe("Include versions that are currently deployed"),
+      deployedOrReleased: z.boolean().optional().describe("Include versions that are currently deployed or released"),
+      environment: z.string().optional().describe("Environment name"),
+      fallbackBranch: z.string().optional().describe("Fallback branch if primary branch doesn't exist"),
+      latest: z.boolean().optional().describe("Select only the latest version"),
+      mainBranch: z.boolean().optional().describe("Select versions from the consumer's main branch"),
+      matchingBranch: z.boolean().optional().describe(
+        "Select versions from the branch that matches the provider branch"
+      ),
+      released: z.boolean().optional().describe("Include versions that are currently released"),
+      tag: z.string().optional().describe("Tag name (legacy, prefer branch)")
+    })
+  ).optional().describe("Selectors specifying which consumer versions to include"),
+  includePendingStatus: z.boolean().optional().describe("Include the pending status in the results"),
+  includeWipPactsSince: z.string().optional().describe("Include WIP pacts published since this date (ISO 8601)"),
+  providerVersionBranch: z.string().optional().describe("Branch of the provider version being verified"),
+  providerVersionTags: z.array(z.string()).optional().describe("Tags for the provider version being verified")
+});
+const GetLabelSchema = z.object({
+  pacticipantName: z.string().describe("Name of the pacticipant"),
+  labelName: z.string().describe("Name of the label")
+});
+const LabelByNameSchema = z.object({
+  labelName: z.string().describe("Label name to filter by")
+});
+const UpdatePacticipantSchema = z.object({
+  pacticipantName: z.string().describe("Name of the pacticipant to update"),
+  displayName: z.string().optional().describe("Human-readable display name"),
+  mainBranch: z.string().optional().describe("Name of the main/trunk branch (e.g. 'main')"),
+  repositoryName: z.string().optional().describe("Repository name"),
+  repositoryNamespace: z.string().optional().describe("Repository namespace/organisation"),
+  repositoryUrl: z.string().optional().describe("URL of the source repository")
+});
+const UpdateVersionSchema = z.object({
+  pacticipantName: z.string().describe("Name of the pacticipant"),
+  versionNumber: z.string().describe("Version number to update"),
+  buildUrl: z.string().optional().describe("URL of the CI build that produced this version")
+});
+const GetBranchVersionsSchema = z.object({
+  pacticipantName: z.string().describe("Name of the pacticipant"),
+  branchName: z.string().describe("Name of the branch"),
+  pageNumber: z.number().optional().describe("Page number"),
+  pageSize: z.number().optional().describe("Results per page")
+});
+const GetVersionDeployedSchema = z.object({
+  pacticipantName: z.string().describe("Name of the pacticipant"),
+  versionNumber: z.string().describe("Version number"),
+  environmentId: z.string().describe("UUID of the environment")
+});
+const GetBiDirectionalProviderVersionSchema = z.object({
+  providerName: z.string().describe("Name of the provider"),
+  providerVersionNumber: z.string().describe("Provider version number")
+});
+const GetBiDirectionalConsumerProviderVersionSchema = z.object({
+  providerName: z.string().describe("Name of the provider"),
+  providerVersionNumber: z.string().describe("Provider version number"),
+  consumerName: z.string().describe("Name of the consumer"),
+  consumerVersionNumber: z.string().describe("Consumer version number")
+});
+const CreateEnvironmentSchema = z.object({
+  name: z.string().min(1).describe("Unique name for the environment (e.g. 'production', 'staging')"),
+  production: z.boolean().describe("Whether this is a production environment"),
+  displayName: z.string().optional().describe("Human-readable display name"),
+  teamUuids: z.array(z.string().uuid()).optional().describe("UUIDs of teams that own this environment")
+});
+const UpdateEnvironmentSchema = z.object({
+  environmentId: z.string().describe("UUID of the environment to update"),
+  name: z.string().min(1).describe("Unique name for the environment"),
+  production: z.boolean().describe("Whether this is a production environment"),
+  displayName: z.string().optional().describe("Human-readable display name"),
+  teamUuids: z.array(z.string().uuid()).optional().describe("UUIDs of teams that own this environment")
+});
+const CreatePacticipantSchema = z.object({
+  name: z.string().min(1).describe("Name of the pacticipant (cannot be changed after creation)"),
+  displayName: z.string().optional().describe("Human-readable display name"),
+  mainBranch: z.string().optional().describe("Name of the main/trunk branch (e.g. 'main')"),
+  repositoryName: z.string().optional().describe("Repository name"),
+  repositoryNamespace: z.string().optional().describe("Repository namespace/organisation"),
+  repositoryUrl: z.string().optional().describe("URL of the source repository")
+});
+const DeletePacticipantSchema = z.object({
+  pacticipantName: z.string().describe("Name of the pacticipant to delete")
+});
+const GetBranchSchema = z.object({
+  pacticipantName: z.string().describe("Name of the pacticipant"),
+  branchName: z.string().describe("Name of the branch")
+});
+const DeleteBranchSchema = z.object({
+  pacticipantName: z.string().describe("Name of the pacticipant"),
+  branchName: z.string().describe("Name of the branch to delete")
+});
+const ManageLabelSchema = z.object({
+  pacticipantName: z.string().describe("Name of the pacticipant"),
+  labelName: z.string().describe("Name of the label")
+});
+const GetIntegrationsByTeamSchema = z.object({
+  teamId: z.string().describe("UUID of the team")
+});
+const DeleteIntegrationSchema = z.object({
+  providerName: z.string().describe("Name of the provider"),
+  consumerName: z.string().describe("Name of the consumer")
+});
+const WebhookRequestSchema = z.object({
+  method: z.literal("POST").describe("HTTP method (must be POST)"),
+  url: z.string().url().describe("URL to send the webhook request to"),
+  body: z.any().optional().describe("Request body to send"),
+  headers: z.record(z.string(), z.string()).optional().describe("HTTP headers to include"),
+  username: z.string().optional().describe("Username for basic auth"),
+  password: z.string().optional().describe("Password for basic auth")
+});
+const WebhookEventSchema = z.object({
+  name: z.string().describe(
+    "Event name (e.g. 'contract_content_changed', 'provider_verification_published')"
+  )
+});
+const CreateWebhookSchema = z.object({
+  description: z.string().describe("Human-readable description of the webhook"),
+  events: z.array(WebhookEventSchema).min(1).describe("Events that trigger this webhook"),
+  request: WebhookRequestSchema.describe("HTTP request to send when triggered"),
+  consumer: z.object({ name: z.string() }).optional().describe("Restrict to a specific consumer (omit for all)"),
+  provider: z.object({ name: z.string() }).optional().describe("Restrict to a specific provider (omit for all)"),
+  enabled: z.boolean().optional().default(true).describe("Whether the webhook is enabled"),
+  teamUuid: z.string().uuid().nullable().optional().describe("UUID of the owning team (null for global)")
+});
+const UpdateWebhookSchema = z.object({
+  webhookId: z.string().describe("UUID of the webhook to update"),
+  description: z.string().optional().describe("Human-readable description"),
+  events: z.array(WebhookEventSchema).optional().describe("Events that trigger this webhook"),
+  request: WebhookRequestSchema.optional().describe(
+    "HTTP request to send when triggered"
+  ),
+  consumer: z.object({ name: z.string() }).nullable().optional().describe("Restrict to a specific consumer"),
+  provider: z.object({ name: z.string() }).nullable().optional().describe("Restrict to a specific provider"),
+  enabled: z.boolean().optional().describe("Whether the webhook is enabled"),
+  teamUuid: z.string().uuid().nullable().optional().describe("UUID of the owning team")
+});
+const WebhookIdSchema = z.object({
+  webhookId: z.string().describe("UUID of the webhook")
+});
+const CreateSecretSchema = z.object({
+  name: z.string().min(1).describe("Name of the secret"),
+  value: z.string().min(1).describe("Value of the secret"),
+  description: z.string().nullable().optional().describe("Description of the secret"),
+  teamUuid: z.string().uuid().optional().describe("UUID of the owning team (cannot be changed after creation)")
+});
+const UpdateSecretSchema = z.object({
+  secretId: z.string().describe("UUID of the secret to update"),
+  name: z.string().optional().describe("New name for the secret"),
+  value: z.string().optional().describe("New value for the secret"),
+  description: z.string().nullable().optional().describe("New description")
+});
+const SecretIdSchema = z.object({
+  secretId: z.string().describe("UUID of the secret")
+});
+const RegenerateTokenSchema = z.object({
+  tokenId: z.string().describe("ID of the token to regenerate")
+});
+const AuditSchema = z.object({
+  since: z.string().optional().describe("Only include events at or after this ISO 8601 timestamp"),
+  userUuid: z.string().uuid().optional().describe("Filter events by PactFlow user UUID"),
+  type: z.string().optional().describe("Filter events by type (e.g. 'pact_publication')"),
+  sort: z.string().optional().describe("Sort order: '+timestamp' (asc, default) or '-timestamp' (desc)"),
+  from: z.string().optional().describe(
+    "Start result set from this audit event UUID (keyset pagination)"
+  ),
+  pageNumber: z.number().int().min(1).optional().describe("Page number"),
+  pageSize: z.number().int().min(1).max(100).optional().describe("Results per page (max 100)")
+});
+const ListAdminUsersSchema = z.object({
+  active: z.boolean().optional().describe("Filter by active/inactive status"),
+  q: z.string().optional().describe("Filter by name or email"),
+  userType: z.number().min(0).max(1).optional().describe("0 = regular users, 1 = system accounts"),
+  page: z.number().optional().describe("Page number"),
+  size: z.number().optional().describe("Results per page")
+});
+const AdminUserIdSchema = z.object({
+  userId: z.string().describe("UUID of the user")
+});
+const CreateAdminUserSchema = z.object({
+  email: z.string().email().describe("Email address of the new user"),
+  name: z.string().describe("Display name of the new user"),
+  firstName: z.string().optional().describe("First name"),
+  lastName: z.string().optional().describe("Last name"),
+  externalIdpId: z.string().optional().describe("External identity provider ID (for SAML/SSO)"),
+  externalIdpUsername: z.string().optional().describe("External IdP username (for SAML/SSO)")
+});
+const UpdateAdminUserSchema = z.object({
+  userId: z.string().describe("UUID of the user to update"),
+  active: z.boolean().optional().describe("Whether the user is active"),
+  email: z.string().email().optional().describe("New email address"),
+  firstName: z.string().optional().describe("First name"),
+  lastName: z.string().optional().describe("Last name"),
+  name: z.string().optional().describe("Display name")
+});
+const InviteUsersSchema = z.object({
+  users: z.array(
+    z.object({
+      email: z.string().email().describe("Email address"),
+      name: z.string().min(1).describe("Display name")
+    })
+  ).min(1).describe("List of users to invite")
+});
+const SetUserRolesSchema = z.object({
+  userId: z.string().describe("UUID of the user"),
+  roles: z.array(z.string()).describe("Array of role UUIDs to assign")
+});
+const UserRoleSchema = z.object({
+  userId: z.string().describe("UUID of the user"),
+  roleId: z.string().describe("UUID of the role")
+});
+const ListAdminTeamsSchema = z.object({
+  q: z.string().optional().describe("Filter teams by name"),
+  page: z.number().optional().describe("Page number"),
+  size: z.number().optional().describe("Results per page")
+});
+const AdminTeamIdSchema = z.object({
+  teamId: z.string().describe("UUID of the team")
+});
+const CreateTeamSchema = z.object({
+  name: z.string().min(1).describe("Name of the team"),
+  administratorUuids: z.array(z.string().uuid()).optional().describe("UUIDs of team administrators"),
+  environmentUuids: z.array(z.string().uuid()).optional().describe("UUIDs of environments assigned to this team"),
+  pacticipantNames: z.array(z.string().min(1)).optional().describe("Names of pacticipants assigned to this team")
+});
+const UpdateTeamSchema = z.object({
+  teamId: z.string().describe("UUID of the team to update"),
+  name: z.string().min(1).describe("Name of the team"),
+  administratorUuids: z.array(z.string().uuid()).optional().describe("UUIDs of team administrators"),
+  environmentUuids: z.array(z.string().uuid()).optional().describe("UUIDs of environments assigned to this team"),
+  pacticipantNames: z.array(z.string().min(1)).optional().describe("Names of pacticipants assigned to this team")
+});
+const TeamUserIdSchema = z.object({
+  teamId: z.string().describe("UUID of the team"),
+  userId: z.string().describe("UUID of the user")
+});
+const PatchTeamUsersSchema = z.object({
+  teamId: z.string().describe("UUID of the team"),
+  operations: z.array(
+    z.object({
+      op: z.enum(["add", "remove"]).describe("Operation: 'add' or 'remove'"),
+      path: z.literal("/users").describe("JSON Patch path (must be '/users')"),
+      value: z.object({
+        uuid: z.string().uuid().describe("UUID of the user")
+      })
+    })
+  ).describe("JSON Patch operations to apply")
+});
+const SetTeamUsersSchema = z.object({
+  teamId: z.string().describe("UUID of the team"),
+  uuids: z.array(z.string().uuid()).describe("UUIDs of users to set as team members (replaces existing)")
+});
+const AdminRoleIdSchema = z.object({
+  roleId: z.string().describe("UUID of the role")
+});
+const CreateRoleSchema = z.object({
+  name: z.string().min(1).describe("Name of the role"),
+  permissions: z.array(
+    z.object({
+      scope: z.string().describe("Permission scope (e.g. 'webhook:read', 'user:manage')")
+    })
+  ).describe("Permissions granted by this role"),
+  description: z.string().optional().describe("Description of the role")
+});
+const UpdateRoleSchema = z.object({
+  roleId: z.string().describe("UUID of the role to update"),
+  name: z.string().min(1).describe("Name of the role"),
+  permissions: z.array(
+    z.object({
+      scope: z.string().describe("Permission scope")
+    })
+  ).describe("Permissions granted by this role"),
+  description: z.string().optional().describe("Description of the role")
+});
+const CreateSystemAccountSchema = z.object({
+  name: z.string().min(1).describe("Name of the system account")
+});
+const GetSystemAccountTokensSchema = z.object({
+  accountId: z.string().describe("UUID of the system account")
+});
+const GetPacticipantNetworkSchema = z.object({
+  pacticipantName: z.string().describe("Name of the pacticipant to get network for")
+});
 export {
+  AdminRoleIdSchema,
+  AdminTeamIdSchema,
+  AdminUserIdSchema,
+  AuditSchema,
   CanIDeploySchema,
-  MatrixSchema
+  CreateAdminUserSchema,
+  CreateEnvironmentSchema,
+  CreatePacticipantSchema,
+  CreateRoleSchema,
+  CreateSecretSchema,
+  CreateSystemAccountSchema,
+  CreateTeamSchema,
+  CreateWebhookSchema,
+  DeleteBranchSchema,
+  DeleteIntegrationSchema,
+  DeletePacticipantSchema,
+  GetBiDirectionalConsumerProviderVersionSchema,
+  GetBiDirectionalProviderVersionSchema,
+  GetBranchSchema,
+  GetBranchVersionsSchema,
+  GetCurrentlyDeployedSchema,
+  GetCurrentlySupportedSchema,
+  GetEnvironmentSchema,
+  GetIntegrationsByTeamSchema,
+  GetLabelSchema,
+  GetLatestVersionSchema,
+  GetPacticipantNetworkSchema,
+  GetPacticipantSchema,
+  GetPactsForVerificationSchema,
+  GetSystemAccountTokensSchema,
+  GetVersionDeployedSchema,
+  GetVersionSchema,
+  InviteUsersSchema,
+  LabelByNameSchema,
+  ListAdminTeamsSchema,
+  ListAdminUsersSchema,
+  ListBranchesSchema,
+  ListVersionsSchema,
+  ManageLabelSchema,
+  MatrixSchema,
+  PatchTeamUsersSchema,
+  PublishConsumerContractsSchema,
+  PublishProviderContractSchema,
+  RecordDeploymentSchema,
+  RecordReleaseSchema,
+  RegenerateTokenSchema,
+  SecretIdSchema,
+  SetTeamUsersSchema,
+  SetUserRolesSchema,
+  TeamUserIdSchema,
+  UpdateAdminUserSchema,
+  UpdateEnvironmentSchema,
+  UpdatePacticipantSchema,
+  UpdateRoleSchema,
+  UpdateSecretSchema,
+  UpdateTeamSchema,
+  UpdateVersionSchema,
+  UpdateWebhookSchema,
+  UserRoleSchema,
+  WebhookIdSchema
 };