@smartbear/mcp 0.19.2 → 0.21.1

package/dist/qtm4j/resolver/resolvers/component-resolver.js

@@ -0,0 +1,56 @@
+import { ENDPOINTS } from "../../config/constants.js";
+import { ResolverKeys } from "../../config/field-resolution.types.js";
+import { Cache } from "../cache/cache.js";
+import { Resolver } from "./resolver.js";
+class ComponentResolver extends Resolver {
+  fieldKeys = [
+    ResolverKeys.SearchableField.COMPONENTS
+  ];
+  cache;
+  apiClient;
+  constructor(apiClient, cacheService) {
+    super();
+    this.apiClient = apiClient;
+    this.cache = new Cache(cacheService);
+  }
+  async resolve(inputField, resolverKey, body, context, warnings) {
+    const raw = body[inputField];
+    if (raw == null) return;
+    const isArray = Array.isArray(raw);
+    const names = isArray ? raw : [raw];
+    const ids = [];
+    for (const name of names) {
+      const id = await this.resolveAndReturn(
+        context.projectKey,
+        context.projectId,
+        resolverKey,
+        name
+      );
+      if (id !== void 0) {
+        ids.push(Number(id));
+      } else {
+        warnings.push(
+          `Skipped ${inputField} '${name}' — not available in the current project.`
+        );
+      }
+    }
+    if (ids.length > 0) {
+      body[inputField] = isArray ? ids : ids[0];
+    }
+  }
+  async resolveAndReturn(projectKey, projectId, resolverKey, name) {
+    const cached = this.cache.matchValue(projectKey, resolverKey, name);
+    if (cached !== void 0) return cached;
+    const response = await this.apiClient.get(ENDPOINTS.COMPONENTS(projectId), {
+      search: name
+    });
+    this.cache.set(projectKey, resolverKey, response);
+    return this.cache.matchValue(projectKey, resolverKey, name);
+  }
+  clearCache(projectKey) {
+    this.cache.clear(projectKey);
+  }
+}
+export {
+  ComponentResolver
+};

package/dist/qtm4j/resolver/resolvers/label-resolver.js

@@ -0,0 +1,56 @@
+import { ENDPOINTS } from "../../config/constants.js";
+import { ResolverKeys } from "../../config/field-resolution.types.js";
+import { Cache } from "../cache/cache.js";
+import { Resolver } from "./resolver.js";
+class LabelResolver extends Resolver {
+  fieldKeys = [
+    ResolverKeys.SearchableField.LABEL
+  ];
+  cache;
+  apiClient;
+  constructor(apiClient, cacheService) {
+    super();
+    this.apiClient = apiClient;
+    this.cache = new Cache(cacheService);
+  }
+  async resolve(inputField, resolverKey, body, context, warnings) {
+    const raw = body[inputField];
+    if (raw == null) return;
+    const isArray = Array.isArray(raw);
+    const names = isArray ? raw : [raw];
+    const ids = [];
+    for (const name of names) {
+      const id = await this.resolveAndReturn(
+        context.projectKey,
+        context.projectId,
+        resolverKey,
+        name
+      );
+      if (id !== void 0) {
+        ids.push(Number(id));
+      } else {
+        warnings.push(
+          `Skipped ${inputField} '${name}' — not available in the current project.`
+        );
+      }
+    }
+    if (ids.length > 0) {
+      body[inputField] = isArray ? ids : ids[0];
+    }
+  }
+  async resolveAndReturn(projectKey, projectId, resolverKey, name) {
+    const cached = this.cache.matchValue(projectKey, resolverKey, name);
+    if (cached !== void 0) return cached;
+    const response = await this.apiClient.get(ENDPOINTS.LABELS(projectId), {
+      search: name
+    });
+    this.cache.set(projectKey, resolverKey, response);
+    return this.cache.matchValue(projectKey, resolverKey, name);
+  }
+  clearCache(projectKey) {
+    this.cache.clear(projectKey);
+  }
+}
+export {
+  LabelResolver
+};

package/dist/qtm4j/resolver/resolvers/resolver.js

@@ -0,0 +1,6 @@
+class Resolver {
+  fieldKeys = [];
+}
+export {
+  Resolver
+};

package/dist/qtm4j/resolver/resolvers/test-case-uid-resolver.js

@@ -0,0 +1,28 @@
+import { ENDPOINTS } from "../../config/constants.js";
+import { ResolverKeys } from "../../config/field-resolution.types.js";
+import { Resolver } from "./resolver.js";
+class TestCaseUidResolver extends Resolver {
+  fieldKeys = [
+    ResolverKeys.SearchableField.TEST_CASE_KEY_TO_UID
+  ];
+  apiClient;
+  constructor(apiClient) {
+    super();
+    this.apiClient = apiClient;
+  }
+  async resolve(_inputField, _resolverKey, _body, _context, _warnings) {
+  }
+  async resolveAndReturn(projectId, keys) {
+    if (keys.length === 0) return {};
+    const response = await this.apiClient.get(
+      ENDPOINTS.RESOLVE_TEST_CASE_IDS(projectId),
+      { keys: keys.join(",") }
+    );
+    return response;
+  }
+  clearCache(_projectKey) {
+  }
+}
+export {
+  TestCaseUidResolver
+};

package/dist/qtm4j/schema/get-test-case.schema.js

@@ -0,0 +1,153 @@
+import * as zod from "zod";
+import { PAGINATION } from "../config/constants.js";
+const SearchTestCaseFilter = zod.object({
+  projectId: zod.string().optional().describe(
+    "Project ID as a numeric string (e.g. '10000'). Auto-populated from active project context if omitted."
+  ),
+  searchText: zod.string().optional().describe(
+    "Free-text search across summary and description. Case-insensitive. Example: 'login functionality'"
+  ),
+  status: zod.array(zod.string()).optional().describe(
+    "Status names to include (OR logic within array). Examples: ['Done'], ['To Do', 'In Progress']. Common values: 'Done', 'To Do', 'In Progress'."
+  ),
+  priority: zod.array(zod.string()).optional().describe(
+    "Priority names to include (OR logic within array). Examples: ['High'], ['High', 'Medium']. Common values: 'High', 'Medium', 'Low'."
+  ),
+  labels: zod.array(zod.string()).optional().describe(
+    "Label names to include (OR logic within array). Example: ['Release_1', 'Sprint 1']. Use exact label names as configured in the project."
+  ),
+  components: zod.array(zod.string()).optional().describe(
+    "Component names to include (OR logic within array). Example: ['UI', 'Cloud', 'API']. Use exact component names as configured in the project."
+  ),
+  folders: zod.array(zod.number()).optional().describe(
+    "Folder IDs (numeric, OR logic within array). Example: [123, 456]. Retrieve folder IDs from the project's folder structure."
+  ),
+  assignee: zod.array(zod.string()).optional().describe(
+    "Jira account IDs of assignees (OR logic within array). Example: ['712020:ddc8e24b-2de7-404b-b9ed-3d7b241e2ced']. Multiple IDs match test cases assigned to any of them."
+  ),
+  reporter: zod.array(zod.string()).optional().describe(
+    "Jira account IDs of reporters (OR logic within array). Example: ['712020:b8479b55-6d23-478c-a2ad-4c8ce176e1fc']."
+  ),
+  isAutomated: zod.boolean().optional().describe(
+    "Automation status filter: true = automated tests only, false = manual tests only. Omit to include both."
+  ),
+  createdOnFrom: zod.string().optional().describe(
+    "Lower bound for creation date (inclusive). Format: 'dd/MMM/yyyy', e.g. '01/Jan/2026'."
+  ),
+  createdOnTo: zod.string().optional().describe(
+    "Upper bound for creation date (inclusive). Format: 'dd/MMM/yyyy', e.g. '31/Dec/2026'."
+  ),
+  updatedOnFrom: zod.string().optional().describe(
+    "Lower bound for last-updated date (inclusive). Format: 'dd/MMM/yyyy', e.g. '01/Apr/2026'."
+  ),
+  updatedOnTo: zod.string().optional().describe(
+    "Upper bound for last-updated date (inclusive). Format: 'dd/MMM/yyyy', e.g. '30/Apr/2026'."
+  ),
+  executedOnFrom: zod.string().optional().describe(
+    "Lower bound for last-execution date (inclusive). Format: 'dd/MMM/yyyy', e.g. '27/Apr/2026'."
+  ),
+  executedOnTo: zod.string().optional().describe(
+    "Upper bound for last-execution date (inclusive). Format: 'dd/MMM/yyyy', e.g. '03/May/2026'."
+  ),
+  fixVersions: zod.array(zod.number()).optional().describe(
+    "Fix version IDs (numeric, OR logic within array). Example: [789]. Retrieve IDs from the project's fix version list."
+  ),
+  sprint: zod.array(zod.number()).optional().describe(
+    "Sprint IDs (numeric, OR logic within array). Example: [10, 11]. Retrieve IDs from the project's sprint list."
+  ),
+  aiGenerated: zod.boolean().optional().describe(
+    "AI generation flag: true = AI-generated test cases only, false = human-authored only. Omit to include both."
+  )
+}).describe(
+  "Filter criteria — multiple fields are combined with AND; multiple values within one field use OR."
+);
+const FIELDS_DESCRIPTION = "Fields to include in each result object. If omitted, all fields are returned. Available fields: key, summary, description, priority, status, assignee, isAutomated, reporter, estimatedTime, labels, components, fixVersions, sprint, folders, updated, created, executed, flakyScore, passRateScore, aiGenerated, precondition, orderNo, seqNo, version. Example: ['key', 'summary', 'status', 'priority', 'assignee']";
+const SearchTestCaseBody = zod.object({
+  filter: SearchTestCaseFilter.optional(),
+  fields: zod.array(zod.string()).optional().describe(FIELDS_DESCRIPTION),
+  startAt: zod.number().min(0).optional().default(PAGINATION.DEFAULT_START_AT).describe(
+    "Zero-indexed offset for pagination (URL query param). First page: 0. Second page: 50 (when maxResults=50). Default: 0."
+  ),
+  maxResults: zod.number().min(PAGINATION.MIN_ALLOWED_RESULTS).max(PAGINATION.MAX_ALLOWED_RESULTS_TEST_CASES).optional().default(PAGINATION.DEFAULT_MAX_RESULTS_TEST_CASES).describe(
+    "Number of results per page (URL query param). Default: 50. Maximum: 50 (backend enforced). To page through results, increment startAt by 50 until startAt >= total."
+  ),
+  sort: zod.string().optional().describe(
+    "Sort pattern sent as a URL query param. Format: 'fieldName:order'. For multiple fields, comma-separate: 'priority:asc,created:desc'. Order values: 'asc' (oldest/lowest first) or 'desc' (newest/highest first). Sortable fields: key, summary, created, updated, status, priority, executed. Examples: 'created:desc', 'key:asc', 'priority:desc,created:asc'"
+  )
+});
+zod.object({
+  createdBy: zod.string().optional(),
+  createdOn: zod.string().optional(),
+  updatedBy: zod.string().optional(),
+  updatedOn: zod.string().optional()
+});
+const VersionSchema = zod.object({
+  isLatestVersion: zod.boolean().optional(),
+  versionNo: zod.number().optional()
+});
+const StatusSchema = zod.object({
+  isArchive: zod.boolean().optional(),
+  color: zod.string().optional(),
+  name: zod.string().optional(),
+  id: zod.number().optional()
+});
+const PrioritySchema = zod.object({
+  name: zod.string().optional(),
+  id: zod.number().optional()
+});
+const LabelSchema = zod.object({
+  name: zod.string().optional(),
+  id: zod.number().optional()
+});
+const ComponentSchema = zod.object({
+  name: zod.string().optional(),
+  id: zod.number().optional()
+});
+const TestCaseSchema = zod.object({
+  id: zod.string().describe("Internal test case ID"),
+  key: zod.string().describe("Test case key, e.g. 'SCRUM-TC-145'"),
+  summary: zod.string().describe("Test case title"),
+  description: zod.string().nullable().optional(),
+  priority: PrioritySchema.optional(),
+  status: StatusSchema.optional(),
+  assignee: zod.string().nullable().optional(),
+  reporter: zod.string().optional(),
+  isAutomated: zod.boolean().optional(),
+  automated: zod.boolean().optional(),
+  estimatedTime: zod.string().nullable().optional(),
+  labels: zod.array(LabelSchema).nullable().optional(),
+  components: zod.array(ComponentSchema).nullable().optional(),
+  fixVersions: zod.array(zod.any()).nullable().optional(),
+  sprint: zod.any().nullable().optional(),
+  folders: zod.array(zod.any()).nullable().optional(),
+  created: zod.any().optional(),
+  updated: zod.any().optional(),
+  executed: zod.string().nullable().optional(),
+  flakyScore: zod.number().nullable().optional(),
+  passRateScore: zod.number().nullable().optional(),
+  aiGenerated: zod.boolean().optional(),
+  precondition: zod.string().nullable().optional(),
+  orderNo: zod.number().nullable().optional(),
+  seqNo: zod.number().nullable().optional(),
+  version: VersionSchema.optional(),
+  projectId: zod.number().optional(),
+  shareable: zod.boolean().optional(),
+  archived: zod.boolean().optional()
+}).passthrough();
+const SearchTestCaseResponse = zod.object({
+  total: zod.number().describe("Total test cases matching the filter (across all pages)"),
+  startAt: zod.number().describe("Offset of this page"),
+  maxResults: zod.number().describe("Page size used for this response"),
+  data: zod.array(TestCaseSchema).describe("Test cases on this page")
+});
+export {
+  ComponentSchema,
+  LabelSchema,
+  PrioritySchema,
+  SearchTestCaseBody,
+  SearchTestCaseFilter,
+  SearchTestCaseResponse,
+  StatusSchema,
+  TestCaseSchema,
+  VersionSchema
+};

package/dist/qtm4j/schema/get-test-steps.schema.js

@@ -0,0 +1,74 @@
+import * as zod from "zod";
+import { PAGINATION } from "../config/constants.js";
+const GetTestStepsFilter = zod.object({
+  stepDetails: zod.string().optional().describe(
+    "Substring match on step details (action text). Example: 'Open the application'"
+  ),
+  testData: zod.string().optional().describe(
+    "Substring match on test data. Example: 'Username: user1, Password: pass123'"
+  ),
+  expectedResult: zod.string().optional().describe(
+    "Substring match on expected result. Example: 'User should be logged in successfully'"
+  )
+}).describe(
+  "Text filters for test steps — each field performs a substring match. Multiple fields are combined with AND."
+);
+const GetTestStepsBody = zod.object({
+  key: zod.string().describe(
+    "Test case key in the format '{PROJECT_KEY}-TC-{number}', e.g. 'SCRUM-TC-145'. PROJECT_KEY is the Jira project key (e.g. 'SCRUM'). The number is the test case counter within that project (auto-incremented, not related to seqNo). Obtain keys from the search_test_cases tool or directly from QTM4J."
+  ),
+  versionNo: zod.number().int().min(1).optional().describe(
+    "Test case version number. Defaults to the latest version if omitted. Obtain from search_test_cases response field: version.versionNo"
+  ),
+  filter: GetTestStepsFilter.optional(),
+  startAt: zod.number().min(0).optional().default(PAGINATION.DEFAULT_START_AT).describe(
+    "Zero-indexed offset for pagination (URL query param). Default: 0."
+  ),
+  maxResults: zod.number().min(PAGINATION.MIN_ALLOWED_RESULTS).max(PAGINATION.MAX_ALLOWED_RESULTS_TEST_STEPS).optional().default(PAGINATION.DEFAULT_MAX_RESULTS_TEST_STEPS).describe(
+    "Number of steps per page (URL query param). Default: 50. Maximum: 100."
+  ),
+  sort: zod.string().optional().describe(
+    "Sort pattern (URL query param). Format: 'fieldName:order'. Sortable fields: stepDetails, testData, seqNo, expectedResult. Order values: 'asc' or 'desc'. Example: 'seqNo:asc'"
+  )
+});
+const ShareableTestStepSchema = zod.object({
+  id: zod.number().optional(),
+  seqNo: zod.union([zod.string(), zod.number()]).optional().describe("Sequence number within the shared test case, e.g. '1.1', '1.3'"),
+  stepDetails: zod.string().describe("Step action / description — always required"),
+  testData: zod.string().nullish().describe("Input data for this step"),
+  expectedResult: zod.string().nullish().describe("Expected outcome of this step"),
+  testcase_version_id: zod.number().optional()
+});
+const ShareableSchema = zod.object({
+  shareableTestcaseUID: zod.string().optional(),
+  shareableVersionNo: zod.number().optional(),
+  archived: zod.boolean().optional(),
+  projectId: zod.number().optional(),
+  shareableTestSteps: zod.array(ShareableTestStepSchema).optional().describe("Embedded steps from the shared test case")
+}).describe(
+  "Present when this step is a reference to a shared (reusable) test case. Contains its embedded sub-steps."
+);
+const TestStepSchema = zod.object({
+  id: zod.number().describe("Internal test step ID"),
+  seqNo: zod.union([zod.string(), zod.number()]).optional().describe("Step sequence number within the test case (e.g. 1, 2, 3)"),
+  stepDetails: zod.string().describe("Step action / description — always required"),
+  testData: zod.string().nullish().describe("Input data for this step"),
+  expectedResult: zod.string().nullish().describe("Expected outcome of this step"),
+  testcase_version_id: zod.number().optional(),
+  attachmentCount: zod.number().optional().describe("Number of attachments on this step"),
+  shareable: ShareableSchema.nullable().optional()
+}).passthrough();
+const GetTestStepsResponse = zod.object({
+  total: zod.number().describe("Total steps matching the filter (across all pages)"),
+  startAt: zod.number().describe("Offset of this page"),
+  maxResults: zod.number().describe("Page size used for this response"),
+  data: zod.array(TestStepSchema).describe("Test steps on this page")
+});
+export {
+  GetTestStepsBody,
+  GetTestStepsFilter,
+  GetTestStepsResponse,
+  ShareableSchema,
+  ShareableTestStepSchema,
+  TestStepSchema
+};

package/dist/qtm4j/schema/project.schema.js

@@ -0,0 +1,43 @@
+import * as zod from "zod";
+import { PAGINATION, SCHEMA_DESCRIPTIONS } from "../config/constants.js";
+const ProjectSchema = zod.object({
+  id: zod.number().describe("Project ID"),
+  key: zod.string().describe("Project key (e.g., 'SCRUM', 'AD')"),
+  name: zod.string().describe("Project name"),
+  favorite: zod.boolean().optional().describe("Whether project is marked as favorite"),
+  avatarUrl: zod.string().optional().nullable().describe("Project avatar URL"),
+  projectTypeKey: zod.string().optional().nullable().describe("Project type key (e.g., 'software')"),
+  qmetryEnabled: zod.boolean().optional().describe("Whether QMetry is enabled for this project")
+}).passthrough().describe(SCHEMA_DESCRIPTIONS.PROJECT_OBJECT);
+const GetProjectsBody = zod.object({
+  projectId: zod.number().optional().describe("Filter by specific project ID"),
+  search: zod.string().optional().describe(SCHEMA_DESCRIPTIONS.SEARCH_TEXT),
+  qmetryEnabled: zod.boolean().optional().describe(SCHEMA_DESCRIPTIONS.QMETRY_ENABLED),
+  startAt: zod.number().min(PAGINATION.MIN_ALLOWED_RESULTS - 1).default(PAGINATION.DEFAULT_START_AT).describe(SCHEMA_DESCRIPTIONS.START_AT),
+  maxResults: zod.number().min(PAGINATION.MIN_ALLOWED_RESULTS).max(PAGINATION.MAX_ALLOWED_RESULTS).default(PAGINATION.DEFAULT_MAX_RESULTS_PROJECTS).describe(SCHEMA_DESCRIPTIONS.MAX_RESULTS_PROJECTS)
+});
+const GetProjectsResponse = zod.object({
+  total: zod.number().min(PAGINATION.MIN_ALLOWED_RESULTS - 1).describe("Total number of projects"),
+  data: zod.array(ProjectSchema).describe("List of projects")
+});
+const SetProjectContextBody = zod.object({
+  projectKey: zod.string().describe(
+    "Project key (e.g., 'SCRUM'). Use the get_projects tool to discover available project keys."
+  )
+});
+const SetProjectContextResponse = zod.object({
+  projectId: zod.number().describe("Numeric project ID"),
+  projectKey: zod.string().describe("Project key"),
+  projectName: zod.string().describe("Project name"),
+  message: zod.string().describe("Confirmation message"),
+  availableFields: zod.record(zod.string(), zod.record(zod.string(), zod.string())).optional().describe(
+    "Available field values keyed by field name (e.g. 'priority', 'testcase_status'). Use these to map user input via NLP (e.g. user says 'Major' → send 'High')."
+  )
+});
+export {
+  GetProjectsBody,
+  GetProjectsResponse,
+  ProjectSchema,
+  SetProjectContextBody,
+  SetProjectContextResponse
+};

package/dist/qtm4j/schema/test-case.schema.js

@@ -0,0 +1,41 @@
+import * as zod from "zod";
+const TestStepSchema = zod.object({
+  stepDetails: zod.string().describe("Step description/action — always required for each step"),
+  testData: zod.string().optional().describe(
+    "Test data for this step. Always include this field for each step — use empty string if no test data is applicable."
+  ),
+  expectedResult: zod.string().optional().describe(
+    "Expected result after performing the step. Always include this field for each step — describe what should happen."
+  )
+});
+const CreateTestCaseBody = zod.object({
+  summary: zod.string().describe("Test case summary/title"),
+  description: zod.string().optional().describe("Test case description"),
+  folderId: zod.number().optional().describe("Folder ID to place the test case in"),
+  priority: zod.string().optional().describe(
+    "Priority name (e.g., 'High', 'Medium', 'Low'). Auto-resolved to ID."
+  ),
+  status: zod.string().optional().describe(
+    "Status name (e.g., 'To Do', 'In Progress', 'Done'). Auto-resolved to ID."
+  ),
+  assignee: zod.string().optional().describe("Assignee account ID"),
+  reporter: zod.string().optional().describe("Reporter account ID"),
+  components: zod.array(zod.string()).optional().describe(
+    "List of component names (e.g., ['UI', 'Cloud']). Auto-resolved to IDs."
+  ),
+  labels: zod.array(zod.string()).optional().describe(
+    "List of label names (e.g., ['Release_1', 'Sprint 1']). Auto-resolved to IDs."
+  ),
+  steps: zod.array(TestStepSchema).optional().describe("List of test steps")
+});
+const CreateTestCaseResponse = zod.object({
+  id: zod.string().describe("Unique test case ID"),
+  key: zod.string().describe("Test case key (e.g., 'SCRUM-TC-190')"),
+  versionNo: zod.number().describe("Version number"),
+  summary: zod.string().describe("Test case summary")
+});
+export {
+  CreateTestCaseBody,
+  CreateTestCaseResponse,
+  TestStepSchema
+};

package/dist/qtm4j/schema/update-test-case.schema.js

@@ -0,0 +1,45 @@
+import * as zod from "zod";
+const MetadataAddDelete = zod.object({
+  add: zod.array(zod.string()).optional().describe(
+    "Names to add (e.g., ['Release_1', 'Sprint 1']). Auto-resolved to IDs."
+  ),
+  delete: zod.array(zod.string()).optional().describe("Names to remove (e.g., ['Sprint 1']). Auto-resolved to IDs.")
+}).describe(
+  "Add or remove entries by name. Both add and delete are optional — omit either to skip that operation."
+);
+const UpdateTestCaseBody = zod.object({
+  key: zod.string().describe(
+    "Test case key in the format '{PROJECT_KEY}-TC-{number}', e.g. 'SCRUM-TC-145'. Automatically resolved to the internal ID and latest version."
+  ),
+  versionNo: zod.number().int().min(1).optional().describe(
+    "Test case version number to update. Defaults to the latest version if omitted."
+  ),
+  summary: zod.string().min(1).optional().describe("Updated test case summary/title."),
+  description: zod.string().optional().describe("Updated test case description."),
+  precondition: zod.string().optional().describe(
+    "Updated precondition — conditions that must be true before the test is executed."
+  ),
+  priority: zod.string().optional().describe(
+    "Priority name (e.g., 'High', 'Medium', 'Low'). Auto-resolved to ID. Use values from set_project_context response."
+  ),
+  status: zod.string().optional().describe(
+    "Status name (e.g., 'To Do', 'In Progress', 'Done'). Auto-resolved to ID. Use values from set_project_context response."
+  ),
+  assignee: zod.string().optional().describe("Assignee Jira account ID (e.g., '5b10a2844c20165700ede21f')."),
+  estimatedTime: zod.string().regex(/^\d{2}:\d{2}:\d{2}$/, "Must be in HH:MM:SS format").optional().describe("Estimated time in HH:MM:SS format (e.g., '02:30:00')."),
+  labels: MetadataAddDelete.optional().describe(
+    "Labels to add or remove by name. Each name is auto-resolved to its ID."
+  ),
+  components: MetadataAddDelete.optional().describe(
+    "Components to add or remove by name. Each name is auto-resolved to its ID."
+  )
+});
+const UpdateTestCaseResponse = zod.object({
+  key: zod.string().describe("Test case key that was updated"),
+  versionNo: zod.number().describe("Version number that was updated"),
+  updated: zod.literal(true).describe("Confirms the update was applied")
+});
+export {
+  UpdateTestCaseBody,
+  UpdateTestCaseResponse
+};

package/dist/qtm4j/tool/project/get-projects.js

@@ -0,0 +1,111 @@
+import { Tool } from "../../../common/tools.js";
+import { TOOL_NAMES, RESPONSE_FIELDS, PAGINATION, ENDPOINTS } from "../../config/constants.js";
+import { GetProjectsResponse, GetProjectsBody } from "../../schema/project.schema.js";
+class GetProjects extends Tool {
+  specification = {
+    title: TOOL_NAMES.GET_PROJECTS.TITLE,
+    summary: TOOL_NAMES.GET_PROJECTS.SUMMARY,
+    readOnly: true,
+    idempotent: true,
+    inputSchema: GetProjectsBody,
+    outputSchema: GetProjectsResponse,
+    purpose: "Retrieve project information including IDs, keys, and names from QTM4J. Useful for discovering available projects, validating project access, and getting project metadata.",
+    useCases: [
+      "Discover all projects available in QTM4J instance",
+      "Get project IDs and keys for reference in other operations",
+      "Find specific projects by ID",
+      "Search projects by text in project key or name",
+      "Filter projects by QMetry integration status",
+      "List projects with pagination for large QTM4J instances",
+      "Retrieve complete project details (ID, key, name, avatarUrl, projectTypeKey, qmetryEnabled, favorite)",
+      "Validate project access and permissions",
+      "Browse available projects before performing other operations"
+    ],
+    examples: [
+      {
+        description: "Get all projects (default pagination - first 100)",
+        parameters: {},
+        expectedOutput: "List of all projects with IDs, keys, and names (first 100 projects)"
+      },
+      {
+        description: "Get the first 10 projects",
+        parameters: {
+          maxResults: 10
+        },
+        expectedOutput: "List of first 10 projects with their details"
+      },
+      {
+        description: "Get a specific project by ID",
+        parameters: {
+          projectId: 1e4
+        },
+        expectedOutput: "Single project with ID 10000 including key, name, and QMetry status"
+      },
+      {
+        description: "Search projects by text in project key or name",
+        parameters: {
+          search: "SCRUM"
+        },
+        expectedOutput: "Projects matching 'SCRUM' search text in their project keys or names"
+      },
+      {
+        description: "Get only QMetry-enabled projects",
+        parameters: {
+          qmetryEnabled: true
+        },
+        expectedOutput: "List of projects that have QMetry integration enabled"
+      },
+      {
+        description: "Get projects with custom pagination (page 2)",
+        parameters: {
+          startAt: 50,
+          maxResults: 50
+        },
+        expectedOutput: "Second page of projects (items 51-100) with their details"
+      },
+      {
+        description: "Search QMetry-enabled projects by text",
+        parameters: {
+          search: "TEST",
+          qmetryEnabled: true
+        },
+        expectedOutput: "QMetry-enabled projects containing 'TEST' in their project keys"
+      }
+    ],
+    hints: [
+      "Project IDs are numeric (e.g., 10000), project keys are strings (e.g., 'SCRUM')",
+      "Use 'projectId' parameter to filter by a specific project ID",
+      "Use 'search' parameter to search by text in project key or project name",
+      "Use 'qmetryEnabled' parameter to filter projects by QMetry integration status",
+      "Response contains complete project details: id, key, name, favorite, avatarUrl, projectTypeKey, qmetryEnabled",
+      "Pagination: startAt is zero-indexed, maxResults max is 100, default is 100",
+      "Default (no parameters) returns first 100 projects",
+      "Use 'isLast' in response to check if more pages are available",
+      "To get next page: increment startAt by maxResults (0 → 100 → 200)",
+      "Use 'total' in response for total count of matching projects"
+    ],
+    outputDescription: "JSON object containing paginated list of projects with IDs, keys, names, and QMetry status, along with pagination metadata"
+  };
+  handle = async (args) => {
+    const input = GetProjectsBody.parse(args);
+    const body = {
+      [RESPONSE_FIELDS.START_AT]: input.startAt ?? PAGINATION.DEFAULT_START_AT,
+      [RESPONSE_FIELDS.MAX_RESULTS]: input.maxResults ?? PAGINATION.DEFAULT_MAX_RESULTS_PROJECTS,
+      ...input.projectId !== void 0 && { projectId: input.projectId },
+      ...input.search && { search: input.search },
+      ...input.qmetryEnabled !== void 0 && {
+        qmetryEnabled: input.qmetryEnabled
+      }
+    };
+    const apiClient = this.client.getApiClient();
+    const response = await apiClient.post(ENDPOINTS.PROJECTS, body);
+    const validatedResponse = GetProjectsResponse.parse(response);
+    return {
+      structuredContent: validatedResponse,
+      content: []
+    };
+  };
+}
+export {
+  GetProjects
+};