@smartbear/mcp 0.20.0 → 0.22.0

package/dist/qtm4j/resolver/resolver-registry.js

@@ -0,0 +1,70 @@
+import { CommonAttributeResolver } from "./resolvers/common-attribute-resolver.js";
+import { ComponentResolver } from "./resolvers/component-resolver.js";
+import { LabelResolver } from "./resolvers/label-resolver.js";
+import { TestCaseUidResolver } from "./resolvers/test-case-uid-resolver.js";
+const ERROR_NO_PROJECT_CONTEXT = "No active project set. Please call set_project_context before performing this operation.";
+class ResolverRegistry {
+  resolverByKey;
+  commonAttributes;
+  testCaseUidResolver;
+  projectContext;
+  constructor(apiClient, cacheService) {
+    this.commonAttributes = new CommonAttributeResolver(
+      apiClient,
+      cacheService
+    );
+    this.testCaseUidResolver = new TestCaseUidResolver(apiClient);
+    const labelResolver = new LabelResolver(apiClient, cacheService);
+    const componentResolver = new ComponentResolver(apiClient, cacheService);
+    this.resolverByKey = /* @__PURE__ */ new Map();
+    for (const resolver of [
+      this.commonAttributes,
+      labelResolver,
+      componentResolver,
+      this.testCaseUidResolver
+    ]) {
+      for (const key of resolver.fieldKeys) {
+        this.resolverByKey.set(key, resolver);
+      }
+    }
+  }
+  /**
+   * Returns the resolver responsible for the given resolver key.
+   * Tools use this with their FIELD_CONFIG map to dispatch field resolution.
+   */
+  getResolver(resolverKey) {
+    const resolver = this.resolverByKey.get(resolverKey);
+    if (!resolver)
+      throw new Error(`No resolver registered for key '${resolverKey}'`);
+    return resolver;
+  }
+  /**
+   * Direct typed access to the CommonAttributeResolver, used by set_project_context to
+   * eagerly load all common attribute fields (priority, statuses) for LLM NLP mapping.
+   */
+  getCommonAttributeResolver() {
+    return this.commonAttributes;
+  }
+  setProjectContext(context) {
+    this.projectContext = context;
+  }
+  requireProjectContext() {
+    if (!this.projectContext) {
+      throw new Error(ERROR_NO_PROJECT_CONTEXT);
+    }
+    return this.projectContext;
+  }
+  clearCache() {
+    for (const resolver of new Set(this.resolverByKey.values())) {
+      resolver.clearCache();
+    }
+  }
+  clearProjectCache(projectKey) {
+    for (const resolver of new Set(this.resolverByKey.values())) {
+      resolver.clearCache(projectKey);
+    }
+  }
+}
+export {
+  ResolverRegistry
+};

package/dist/qtm4j/resolver/resolvers/common-attribute-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 CommonAttributeResolver extends Resolver {
+  fieldKeys = Object.values(
+    ResolverKeys.CommonAttribute
+  );
+  cache;
+  apiClient;
+  constructor(apiClient, cacheService) {
+    super();
+    this.apiClient = apiClient;
+    this.cache = new Cache(cacheService);
+  }
+  // Priority and status are always single values — no array handling needed.
+  async resolve(inputField, resolverKey, body, context, warnings) {
+    const name = body[inputField];
+    if (name == null) return;
+    const id = await this.resolveAndReturn(
+      context.projectKey,
+      context.projectId,
+      resolverKey,
+      name
+    );
+    if (id !== void 0) {
+      body[inputField] = Number(id);
+    } else {
+      warnings.push(
+        `Skipped ${inputField} '${name}' — not available in the current project.`
+      );
+    }
+  }
+  async resolveAndReturn(projectKey, projectId, resolverKey, name) {
+    const cached = this.cache.matchValue(projectKey, resolverKey, name);
+    if (cached !== void 0) return cached;
+    await this.preload(projectKey, projectId);
+    return this.cache.matchValue(projectKey, resolverKey, name);
+  }
+  async preload(projectKey, projectId) {
+    const response = await this.apiClient.get(
+      ENDPOINTS.COMMON_ATTRIBUTES(projectId)
+    );
+    const attributes = response;
+    for (const [key, values] of Object.entries(attributes)) {
+      this.cache.set(projectKey, key, values);
+    }
+    return attributes;
+  }
+  clearCache(projectKey) {
+    this.cache.clear(projectKey);
+  }
+}
+export {
+  CommonAttributeResolver
+};

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
+};