@smartbear/mcp 0.22.0 → 0.24.0

package/dist/qtm4j/client.js

@@ -5,6 +5,7 @@ import { ApiClient } from "./http/api-client.js";
 import { ResolverRegistry } from "./resolver/resolver-registry.js";
 const ConfigurationSchema = zod__default.object({
   [CONFIG_KEYS.API_KEY]: zod__default.string().describe(SCHEMA_DESCRIPTIONS.API_KEY),
+  [CONFIG_KEYS.AUTOMATION_API_KEY]: zod__default.string().optional().describe(SCHEMA_DESCRIPTIONS.AUTOMATION_API_KEY),
   [CONFIG_KEYS.BASE_URL]: zod__default.string().url().optional().default(API_CONFIG.DEFAULT_BASE_URL).describe(SCHEMA_DESCRIPTIONS.BASE_URL)
 });
 class Qtm4jClient {
@@ -13,6 +14,7 @@ class Qtm4jClient {
   configPrefix = CLIENT_CONFIG.CONFIG_PREFIX;
   config = ConfigurationSchema;
   _apiKey;
+  _automationApiKey;
   baseUrl = API_CONFIG.DEFAULT_BASE_URL;
   apiClient;
   resolverRegistry;
@@ -23,10 +25,15 @@ class Qtm4jClient {
    */
   async configure(server, config) {
     this._apiKey = config[CONFIG_KEYS.API_KEY];
+    this._automationApiKey = config[CONFIG_KEYS.AUTOMATION_API_KEY];
     if (config[CONFIG_KEYS.BASE_URL]) {
       this.baseUrl = config[CONFIG_KEYS.BASE_URL];
     }
-    this.apiClient = new ApiClient(() => this.getAuthToken(), this.baseUrl);
+    this.apiClient = new ApiClient(
+      () => this.getAuthToken(),
+      this.baseUrl,
+      () => this.getAutomationApiKey()
+    );
     this.resolverRegistry = new ResolverRegistry(
       this.apiClient,
       server.getCache()
@@ -48,6 +55,13 @@ class Qtm4jClient {
     }
     return this._apiKey || null;
   }
+  getAutomationApiKey() {
+    const headerKey = getRequestHeader("Qtm4j-Automation-Api-Key");
+    if (headerKey) {
+      return Array.isArray(headerKey) ? headerKey[0] : headerKey;
+    }
+    return this._automationApiKey || null;
+  }
   /**
    * Check if the client is properly configured
    * @returns true if API key is set and client is ready
@@ -91,13 +105,23 @@ class Qtm4jClient {
     const { GetTestCases } = await import("./tool/test-case/get-test-cases.js");
     const { GetTestSteps } = await import("./tool/test-case/get-test-steps.js");
     const { UpdateTestCase } = await import("./tool/test-case/update-test-case.js");
+    const { UploadAutomationResult } = await import("./tool/test-automation/upload-automation-result.js");
+    const { GetAutomationHistory } = await import("./tool/test-automation/get-automation-history.js");
+    const { CreateTestCycle } = await import("./tool/test-cycle/create-test-cycle.js");
+    const { SearchTestCycles } = await import("./tool/test-cycle/search-test-cycle.js");
+    const { UpdateTestCycle } = await import("./tool/test-cycle/update-test-cycle.js");
     const tools = [
       new GetProjects(this),
       new SetProjectContext(this),
       new CreateTestCase(this),
       new GetTestCases(this),
       new GetTestSteps(this),
-      new UpdateTestCase(this)
+      new UpdateTestCase(this),
+      new CreateTestCycle(this),
+      new SearchTestCycles(this),
+      new UpdateTestCycle(this),
+      new UploadAutomationResult(this),
+      new GetAutomationHistory(this)
     ];
     for (const tool of tools) {
       register(tool.specification, tool.handle);

package/dist/qtm4j/config/constants.js

@@ -13,6 +13,12 @@ const ENDPOINTS = {
   SEARCH_TEST_CASES: `${API_CONFIG.API_VERSION}/testcases/search`,
   /** Resolve test case keys → internal UIDs for a given project */
   RESOLVE_TEST_CASE_IDS: (projectId) => `${API_CONFIG.API_VERSION}/projects/${projectId}/mcp/testcases/resolve-ids`,
+  /** Update test cycle endpoint */
+  UPDATE_TEST_CYCLE: (id) => `${API_CONFIG.API_VERSION}/testcycles/${id}`,
+  /** Create test cycle endpoint */
+  CREATE_TEST_CYCLE: `${API_CONFIG.API_VERSION}/testcycles`,
+  /** Search test cycles endpoint */
+  SEARCH_TEST_CYCLES: `${API_CONFIG.API_VERSION}/testcycles/search`,
   /** Update test case endpoint */
   UPDATE_TEST_CASE: (id, versionNo) => `${API_CONFIG.API_VERSION}/testcases/${id}/versions/${versionNo}`,
   /** Test steps search endpoint */
@@ -22,7 +28,13 @@ const ENDPOINTS = {
   /** Labels search endpoint */
   LABELS: (projectId) => `${API_CONFIG.API_VERSION}/projects/${projectId}/mcp/labels`,
   /** Components search endpoint */
-  COMPONENTS: (projectId) => `${API_CONFIG.API_VERSION}/projects/${projectId}/mcp/components`
+  COMPONENTS: (projectId) => `${API_CONFIG.API_VERSION}/projects/${projectId}/mcp/components`,
+  /** Automation: initiate result file import — returns pre-signed S3 upload URL + trackingId */
+  AUTOMATION_IMPORT: "/rest/api/automation/importresult",
+  /** Automation: poll import progress by trackingId */
+  AUTOMATION_IMPORT_TRACK: "/rest/api/automation/importresult/track",
+  /** Automation: paginated history of past automation result uploads */
+  AUTOMATION_HISTORY: "/rest/api/automation/importresult/history"
 };
 const HTTP_HEADERS = {
   /** API key header name */
@@ -38,7 +50,9 @@ const HTTP_HEADERS = {
 };
 const CONTENT_TYPES = {
   /** JSON content type */
-  JSON: "application/json"
+  JSON: "application/json",
+  /** Multipart form-data content type (used for S3 automation file uploads) */
+  MULTIPART: "multipart/form-data"
 };
 const HTTP_METHODS = {
   GET: "GET",
@@ -72,14 +86,24 @@ const PAGINATION = {
   DEFAULT_MAX_RESULTS_TEST_STEPS: 50,
   /** Maximum allowed results per request for test steps */
   MAX_ALLOWED_RESULTS_TEST_STEPS: 100,
+  /** Default maximum results for test cycles */
+  DEFAULT_MAX_RESULTS_TEST_CYCLES: 20,
+  /** Maximum allowed results per request for test cycles */
+  MAX_ALLOWED_RESULTS_TEST_CYCLES: 100,
   /** Minimum allowed results per request */
   MIN_ALLOWED_RESULTS: 1
 };
+const AUTOMATION_LIMITS = {
+  /** Maximum allowed upload file size in bytes (10 MB) */
+  MAX_FILE_SIZE_BYTES: 10 * 1024 * 1024
+};
 const ERROR_MESSAGES = {
   /** Client not configured error */
   CLIENT_NOT_CONFIGURED: "QTM4J client not configured. Please set API key.",
   /** Request failed template */
-  REQUEST_FAILED: (status, errorText) => `Request failed with status ${status}: ${errorText}`
+  REQUEST_FAILED: (status, errorText) => `Request failed with status ${status}: ${errorText}`,
+  /** Automation API key not configured */
+  AUTOMATION_API_KEY_NOT_CONFIGURED: "QTM4J Automation API key not configured. Set the QTM4J_AUTOMATION_API_KEY environment variable or pass the Qtm4j-Automation-Api-Key header."
 };
 const TOOL_NAMES = {
   /** Get Projects tool */
@@ -111,17 +135,46 @@ const TOOL_NAMES = {
   UPDATE_TEST_CASE: {
     TITLE: "Update Test Case",
     SUMMARY: "Update an existing test case in QTM4J. Supports auto-resolving human-readable names for priority, status, labels, and components. Labels and components support add/delete operations."
+  },
+  /** Upload Automation Result tool */
+  UPLOAD_AUTOMATION_RESULT: {
+    TITLE: "Upload Automation Result",
+    SUMMARY: "Upload an automation result file to QTM4J and map the results to a test cycle. Supports JUnit XML, TestNG XML, Cucumber JSON, QAF, HP UFT, and SpecFlow formats."
+  },
+  /** Get Automation History tool */
+  GET_AUTOMATION_HISTORY: {
+    TITLE: "Get Automation History",
+    SUMMARY: "Retrieve a paginated history of past automation result uploads for a QTM4J project."
+  },
+  /** Search Test Cycles tool */
+  SEARCH_TEST_CYCLES: {
+    TITLE: "Search Test Cycles",
+    SUMMARY: "Search for test cycles in a QTM4J project by status, owner, folder, date range, or keyword. projectId is injected automatically from the active project context."
+  },
+  /** Create Test Cycle tool */
+  CREATE_TEST_CYCLE: {
+    TITLE: "Create Test Cycle",
+    SUMMARY: "Create a new test cycle in a QTM4J project. Supports auto-resolving human-readable names for priority and status. Always creates in the 'MCP Generated' folder. projectId is injected automatically from the active project context."
+  },
+  /** Update Test Cycle tool */
+  UPDATE_TEST_CYCLE: {
+    TITLE: "Update Test Cycle",
+    SUMMARY: "Update an existing test cycle in QTM4J by its human-readable key (e.g. 'SCRUM-TR-101'). Supports auto-resolving human-readable names for status and priority. Labels and components support add/delete operations. Only the fields you provide are changed — omitted fields are left as-is. projectId is injected automatically from the active project context."
   }
 };
 const CONFIG_KEYS = {
   /** API key configuration key */
   API_KEY: "api_key",
+  /** Automation API key configuration key */
+  AUTOMATION_API_KEY: "automation_api_key",
   /** Base URL configuration key */
   BASE_URL: "base_url"
 };
 const SCHEMA_DESCRIPTIONS = {
   /** API key description */
   API_KEY: "QTM4J API key for authentication",
+  /** Automation API key description */
+  AUTOMATION_API_KEY: "QTM4J Automation API key for uploading automation result files. This is a separate key from the regular API key and can be found in QTM4J under Automation settings.",
   /** Base URL description */
   BASE_URL: "QTM4J base URL (default: https://qtmcloud.qmetry.com). Can be customized for on-premise installations.",
   /** Start at description */
@@ -133,8 +186,40 @@ const SCHEMA_DESCRIPTIONS = {
   /** QMetry enabled description */
   QMETRY_ENABLED: "Filter by QMetry enabled status",
   /** Project object description */
-  PROJECT_OBJECT: "Project object"
+  PROJECT_OBJECT: "Project object",
+  /** Automation result file path */
+  AUTOMATION_FILE_PATH: "Path to the automation result file on disk. Filesystem contents can change between turns — always resolve this from a fresh scan, never from a previously seen path. Supported extensions: .xml, .json, .zip",
+  /** Automation result format */
+  AUTOMATION_FORMAT: "Format of the result file. Supported values: cucumber, testng, junit, qaf, hpuft, specflow",
+  /** Test cycle to reuse */
+  AUTOMATION_TEST_CYCLE_TO_REUSE: "Work key of an existing test cycle to reuse (e.g. 'TR-PRJ-1'). If omitted, a new test cycle is created.",
+  /** Automation environment */
+  AUTOMATION_ENVIRONMENT: "Name of the environment on which the test cycle was executed (e.g. 'Chrome', 'Staging'). Defaults to 'No Environment'.",
+  /** Automation build */
+  AUTOMATION_BUILD: "Build name or version for the test cycle execution (e.g. '1.0.0-beta'). Defaults to blank.",
+  /** isZip flag */
+  AUTOMATION_IS_ZIP: "Set to true when uploading a ZIP archive containing result files. Required for QAF format.",
+  /** attachFile flag */
+  AUTOMATION_ATTACH_FILE: "Set to true to upload attachments referenced in execution results.",
+  /** matchTestSteps flag */
+  AUTOMATION_MATCH_TEST_STEPS: "true — match test cases by summary AND test steps. false — match by summary or key only.",
+  /** appendTestName flag */
+  AUTOMATION_APPEND_TEST_NAME: "Applicable to JUnit/TestNG only. Appends suite/test name to method name in test case summary.",
+  /** fields object */
+  AUTOMATION_FIELDS: "Additional fields to set on the test cycle, test case, and/or test case execution created during import.",
+  /** getAutomationHistory — pagination */
+  AUTOMATION_HISTORY_START_AT: "Zero-indexed starting position for pagination (default: 0).",
+  AUTOMATION_HISTORY_MAX_RESULTS: "Maximum number of records to return per page (default: 20, max: 100)."
 };
+const AUTOMATION_RESULT_DIRS = [
+  "target/surefire-reports",
+  "target/failsafe-reports",
+  "build/reports/tests",
+  "build/test-results",
+  "test-results",
+  "reports",
+  "cucumber-reports"
+];
 const RESPONSE_FIELDS = {
   /** Start at field */
   START_AT: "startAt",
@@ -143,6 +228,10 @@ const RESPONSE_FIELDS = {
   FIELDS: "fields",
   SORT: "sort"
 };
+const SORT_DEFAULTS = {
+  /** Default sort expression for test cycle search */
+  TEST_CYCLES: "key:asc"
+};
 const EMPTY_VALUES = {
   /** Empty object */
   OBJECT: {},
@@ -153,6 +242,8 @@ const EMPTY_VALUES = {
 };
 export {
   API_CONFIG,
+  AUTOMATION_LIMITS,
+  AUTOMATION_RESULT_DIRS,
   CLIENT_CONFIG,
   CONFIG_KEYS,
   CONTENT_TYPES,
@@ -165,5 +256,6 @@ export {
   PAGINATION,
   RESPONSE_FIELDS,
   SCHEMA_DESCRIPTIONS,
+  SORT_DEFAULTS,
   TOOL_NAMES
 };

package/dist/qtm4j/config/field-resolution.types.js

@@ -8,7 +8,8 @@ const ResolverKeys = {
     TEST_PLAN_STATUS: "testplan_status",
     TEST_CYCLE_STATUS: "testcycle_status",
     PRIORITY: "priority",
-    TESTCASE_FOLDER: "testcase_folder"
+    TESTCASE_FOLDER: "testcase_folder",
+    TEST_CYCLE_FOLDER: "testcycle_folder"
   },
   /**
    * Fields with dedicated search APIs (fetched on-demand, not batch-loaded).

package/dist/qtm4j/http/api-client.js

@@ -4,13 +4,15 @@ import { AuthService } from "./auth-service.js";
 class ApiClient {
   baseUrl;
   tokenProvider;
-  constructor(tokenOrProvider, baseUrl) {
+  automationTokenProvider;
+  constructor(tokenOrProvider, baseUrl, automationTokenProvider) {
     this.baseUrl = baseUrl.trim().replace(/\/$/, EMPTY_VALUES.STRING);
     if (typeof tokenOrProvider === "string") {
       this.tokenProvider = () => tokenOrProvider;
     } else {
       this.tokenProvider = tokenOrProvider;
     }
+    this.automationTokenProvider = automationTokenProvider;
   }
   /**
    * Get authentication headers for current request
@@ -25,6 +27,17 @@ class ApiClient {
     }
     return new AuthService(token).getAuthHeaders();
   }
+  /**
+   * Get authentication headers using the automation API key.
+   * @throws ToolError if automation API key is not configured
+   */
+  getAutomationHeaders() {
+    const token = this.automationTokenProvider?.();
+    if (!token) {
+      throw new ToolError(ERROR_MESSAGES.AUTOMATION_API_KEY_NOT_CONFIGURED);
+    }
+    return new AuthService(token).getAuthHeaders();
+  }
   /**
    * Construct full URL with query parameters
    * @param endpoint - API endpoint path
@@ -89,6 +102,62 @@ class ApiClient {
     });
     return await this.validateAndGetResponseBody(response);
   }
+  /**
+   * Perform GET request using the automation API key (QTM4J_AUTOMATION_API_KEY).
+   * Used for automation endpoints that require the automation key instead of the regular API key.
+   * @param endpoint - API endpoint path
+   * @param params - Optional query parameters
+   * @returns Parsed response data
+   */
+  async getAutomation(endpoint, params) {
+    const response = await fetch(this.getUrl(endpoint, params), {
+      method: HTTP_METHODS.GET,
+      headers: this.getAutomationHeaders()
+    });
+    return await this.validateAndGetResponseBody(response);
+  }
+  /**
+   * Perform POST request using the automation API key (QTM4J_AUTOMATION_API_KEY).
+   * Used for automation import endpoints — same apiKey header as all other APIs,
+   * but the value is the automation key instead of the regular API key.
+   * @param endpoint - API endpoint path
+   * @param body - Request body object
+   * @returns Parsed response data
+   */
+  async postAutomation(endpoint, body) {
+    const url = this.getUrl(endpoint);
+    const requestHeaders = {
+      ...this.getAutomationHeaders(),
+      [HTTP_HEADERS.CONTENT_TYPE]: CONTENT_TYPES.JSON
+    };
+    const response = await fetch(url, {
+      method: HTTP_METHODS.POST,
+      headers: requestHeaders,
+      body: JSON.stringify(body)
+    });
+    return await this.validateAndGetResponseBody(response);
+  }
+  /**
+   * Upload a file as multipart/form-data using the automation API key.
+   * Content-Type is not set manually — fetch sets it with the correct multipart boundary.
+   * @param uploadUrl - Full URL returned by the automation import initiation step
+   * @param fileBuffer - Raw file contents as a Buffer
+   */
+  async uploadFileMultipart(uploadUrl, fileBuffer) {
+    const response = await fetch(uploadUrl, {
+      method: HTTP_METHODS.PUT,
+      headers: {
+        [HTTP_HEADERS.CONTENT_TYPE]: CONTENT_TYPES.MULTIPART
+      },
+      body: new Uint8Array(fileBuffer)
+    });
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new ToolError(
+        ERROR_MESSAGES.REQUEST_FAILED(response.status, errorText)
+      );
+    }
+  }
   /**
    * Validate HTTP response and extract body
    * Handles various response types: JSON, text, empty responses

package/dist/qtm4j/resolver/cache/cache.js

@@ -19,7 +19,7 @@ class Cache {
     if (!this.trackedKeys.has(projectKey)) {
       this.trackedKeys.set(projectKey, /* @__PURE__ */ new Set());
     }
-    this.trackedKeys.get(projectKey).add(key);
+    this.trackedKeys.get(projectKey)?.add(key);
   }
   has(projectKey, fieldKey) {
     return this.cacheService.get(this.compositeKey(projectKey, fieldKey)) !== void 0;

package/dist/qtm4j/resolver/resolvers/common-attribute-resolver.js

@@ -26,6 +26,7 @@ class CommonAttributeResolver extends Resolver {
     if (id !== void 0) {
       body[inputField] = Number(id);
     } else {
+      delete body[inputField];
       warnings.push(
         `Skipped ${inputField} '${name}' — not available in the current project.`
       );

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

@@ -36,6 +36,8 @@ class ComponentResolver extends Resolver {
     }
     if (ids.length > 0) {
       body[inputField] = isArray ? ids : ids[0];
+    } else {
+      delete body[inputField];
     }
   }
   async resolveAndReturn(projectKey, projectId, resolverKey, name) {

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

@@ -36,6 +36,8 @@ class LabelResolver extends Resolver {
     }
     if (ids.length > 0) {
       body[inputField] = isArray ? ids : ids[0];
+    } else {
+      delete body[inputField];
     }
   }
   async resolveAndReturn(projectKey, projectId, resolverKey, name) {

package/dist/qtm4j/schema/automation.schema.js

@@ -0,0 +1,107 @@
+import zod__default from "zod";
+import { SCHEMA_DESCRIPTIONS } from "../config/constants.js";
+const TestCycleFields = zod__default.object({
+  labels: zod__default.array(zod__default.string()).nullable().optional(),
+  components: zod__default.array(zod__default.string()).nullable().optional(),
+  priority: zod__default.string().nullable().optional(),
+  status: zod__default.string().nullable().optional(),
+  summary: zod__default.string().nullable().optional(),
+  description: zod__default.string().nullable().optional(),
+  assignee: zod__default.string().nullable().optional().describe(
+    "Jira Account ID of the assignee. Ask the user to provide their Account ID directly."
+  ),
+  reporter: zod__default.string().nullable().optional().describe(
+    "Jira Account ID of the reporter. Ask the user to provide their Account ID directly."
+  ),
+  folderId: zod__default.number().int().nullable().optional().describe(
+    "Numeric folder ID to place the test cycle in. Right-click a folder in QTM4J and select 'Copy Folder Id' to get this value."
+  ),
+  plannedStartDate: zod__default.string().nullable().optional().describe("Date in 'dd/MMM/yyyy HH:mm' format, e.g. '14/May/2026 10:30'"),
+  plannedEndDate: zod__default.string().nullable().optional().describe("Date in 'dd/MMM/yyyy HH:mm' format, e.g. '14/May/2026 10:30'")
+}).nullable().optional();
+const TestCaseFields = zod__default.object({
+  labels: zod__default.array(zod__default.string()).nullable().optional(),
+  components: zod__default.array(zod__default.string()).nullable().optional(),
+  priority: zod__default.string().nullable().optional(),
+  status: zod__default.string().nullable().optional(),
+  description: zod__default.string().nullable().optional(),
+  precondition: zod__default.string().nullable().optional(),
+  assignee: zod__default.string().nullable().optional().describe(
+    "Jira Account ID of the assignee. Ask the user to provide their Account ID directly."
+  ),
+  reporter: zod__default.string().nullable().optional().describe(
+    "Jira Account ID of the reporter. Ask the user to provide their Account ID directly."
+  ),
+  estimatedTime: zod__default.string().nullable().optional(),
+  folderId: zod__default.number().int().nullable().optional().describe(
+    "Numeric folder ID to place the test cases in. Right-click a folder in QTM4J and select 'Copy Folder Id' to get this value."
+  )
+}).nullable().optional();
+const TestCaseExecutionFields = zod__default.object({
+  comment: zod__default.string().nullable().optional(),
+  actualTime: zod__default.string().nullable().optional(),
+  executionPlannedDate: zod__default.string().nullable().optional(),
+  assignee: zod__default.string().nullable().optional()
+}).nullable().optional();
+const UploadAutomationResultBody = zod__default.object({
+  filePath: zod__default.string().describe(SCHEMA_DESCRIPTIONS.AUTOMATION_FILE_PATH),
+  format: zod__default.enum(["cucumber", "testng", "junit", "qaf", "hpuft", "specflow"]).describe(SCHEMA_DESCRIPTIONS.AUTOMATION_FORMAT),
+  testCycleToReuse: zod__default.string().optional().describe(SCHEMA_DESCRIPTIONS.AUTOMATION_TEST_CYCLE_TO_REUSE),
+  environment: zod__default.string().optional().describe(SCHEMA_DESCRIPTIONS.AUTOMATION_ENVIRONMENT),
+  build: zod__default.string().optional().describe(SCHEMA_DESCRIPTIONS.AUTOMATION_BUILD),
+  isZip: zod__default.boolean().optional().default(false).describe(SCHEMA_DESCRIPTIONS.AUTOMATION_IS_ZIP),
+  attachFile: zod__default.boolean().optional().default(false).describe(SCHEMA_DESCRIPTIONS.AUTOMATION_ATTACH_FILE),
+  matchTestSteps: zod__default.boolean().optional().default(true).describe(SCHEMA_DESCRIPTIONS.AUTOMATION_MATCH_TEST_STEPS),
+  appendTestName: zod__default.boolean().optional().describe(SCHEMA_DESCRIPTIONS.AUTOMATION_APPEND_TEST_NAME),
+  fields: zod__default.object({
+    testCycle: TestCycleFields,
+    testCase: TestCaseFields,
+    testCaseExecution: TestCaseExecutionFields
+  }).optional().describe(SCHEMA_DESCRIPTIONS.AUTOMATION_FIELDS)
+});
+const UploadAutomationResultResponse = zod__default.object({
+  trackingId: zod__default.string(),
+  message: zod__default.string(),
+  filePath: zod__default.string(),
+  format: zod__default.enum(["cucumber", "testng", "junit", "qaf", "hpuft", "specflow"])
+});
+const GetAutomationHistoryBody = zod__default.object({
+  startAt: zod__default.number().int().min(0).optional().default(0).describe(SCHEMA_DESCRIPTIONS.AUTOMATION_HISTORY_START_AT),
+  maxResults: zod__default.number().int().min(1).max(100).optional().default(20).describe(SCHEMA_DESCRIPTIONS.AUTOMATION_HISTORY_MAX_RESULTS)
+});
+const AutomationHistorySummary = zod__default.object({
+  testCycle: zod__default.string().nullable().optional(),
+  testCasesCreated: zod__default.number().nullable().optional(),
+  testCaseVersionsCreated: zod__default.number().nullable().optional(),
+  testCaseVersionsReused: zod__default.number().nullable().optional(),
+  testStepsCreated: zod__default.number().nullable().optional(),
+  testCycleIssueKey: zod__default.string().nullable().optional(),
+  testCycleSummary: zod__default.string().nullable().optional()
+});
+const AutomationHistoryRecord = zod__default.object({
+  trackingId: zod__default.string().nullable().optional(),
+  fileName: zod__default.string().nullable().optional(),
+  format: zod__default.string().nullable().optional(),
+  processStatus: zod__default.string().nullable().optional(),
+  importStatus: zod__default.string().nullable().optional(),
+  startTime: zod__default.string().nullable().optional(),
+  endTime: zod__default.string().nullable().optional(),
+  fileSize: zod__default.number().nullable().optional(),
+  detailedMessage: zod__default.string().nullable().optional(),
+  extraAttributes: zod__default.record(zod__default.string(), zod__default.any()).nullable().optional(),
+  childFileSummaryResponses: zod__default.array(zod__default.any()).nullable().optional(),
+  summary: zod__default.array(AutomationHistorySummary).nullable().optional()
+});
+const GetAutomationHistoryResponse = zod__default.object({
+  startAt: zod__default.number().nullable().optional(),
+  maxResults: zod__default.number().nullable().optional(),
+  total: zod__default.number().nullable().optional(),
+  data: zod__default.array(AutomationHistoryRecord).nullable().optional()
+});
+export {
+  AutomationHistoryRecord,
+  GetAutomationHistoryBody,
+  GetAutomationHistoryResponse,
+  UploadAutomationResultBody,
+  UploadAutomationResultResponse
+};

package/dist/qtm4j/schema/search-test-cycle.schema.js

@@ -0,0 +1,133 @@
+import * as zod from "zod";
+import { SORT_DEFAULTS, PAGINATION } from "../config/constants.js";
+const DATE_RANGE_REGEX = /^\d{2}\/[A-Z][a-z]{2}\/\d{4},\d{2}\/[A-Z][a-z]{2}\/\d{4}$/;
+const DATE_RANGE_DESCRIPTION = "Inclusive date range. Format: 'dd/MMM/yyyy,dd/MMM/yyyy' e.g. '02/Apr/2026,15/May/2026'. Month abbreviation is case-sensitive (Apr not apr or APR). Always provide two dates separated by a comma.";
+const SearchTestCycleFilter = zod.object({
+  projectId: zod.number().optional().describe(
+    "Numeric project ID. Auto-injected from active project context — do not provide."
+  ),
+  status: zod.array(zod.string()).optional().describe(
+    "Status names to include (OR logic within array). Examples: ['In Progress', 'To Do']. Common values: 'To Do', 'In Progress', 'Done'."
+  ),
+  priority: zod.array(zod.string()).optional().describe(
+    "Priority names to include (OR logic within array). Examples: ['High'], ['High', 'Medium']. Common values: 'High', 'Medium', 'Low'."
+  ),
+  assignee: zod.array(zod.string()).optional().describe(
+    "Jira account IDs of assignees (OR logic within array). Example: ['5b10a2844c20165700ede21f']. Multiple IDs match test cycles assigned to any of them."
+  ),
+  reporter: zod.array(zod.string()).optional().describe(
+    "Jira account IDs of reporters (OR logic within array). Example: ['5b10a2844c20165700ede21f']."
+  ),
+  folderId: zod.number().optional().describe(
+    "Folder ID to restrict results to (numeric). Right-click a folder in QTM4J and select 'Copy Folder Id'."
+  ),
+  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']. Use exact component names as configured in the project."
+  ),
+  plannedStartDate: zod.string().regex(
+    DATE_RANGE_REGEX,
+    "Invalid format. Use dd/MMM/yyyy,dd/MMM/yyyy e.g. 02/Apr/2026,15/May/2026"
+  ).optional().describe(DATE_RANGE_DESCRIPTION),
+  plannedEndDate: zod.string().regex(
+    DATE_RANGE_REGEX,
+    "Invalid format. Use dd/MMM/yyyy,dd/MMM/yyyy e.g. 02/Apr/2026,15/May/2026"
+  ).optional().describe(DATE_RANGE_DESCRIPTION),
+  searchText: zod.string().optional().describe(
+    "Free-text search across key, summary, and description. Case-insensitive. Example: 'regression sprint'"
+  ),
+  createdOn: zod.string().regex(
+    DATE_RANGE_REGEX,
+    "Invalid format. Use dd/MMM/yyyy,dd/MMM/yyyy e.g. 01/May/2026,20/May/2026"
+  ).optional().describe(
+    `Filter by creation date range (inclusive). ${DATE_RANGE_DESCRIPTION}`
+  ),
+  updatedOn: zod.string().regex(
+    DATE_RANGE_REGEX,
+    "Invalid format. Use dd/MMM/yyyy,dd/MMM/yyyy e.g. 01/May/2026,21/May/2026"
+  ).optional().describe(
+    "Filter by last-updated date range (inclusive). " + DATE_RANGE_DESCRIPTION
+  ),
+  isAutomated: zod.boolean().optional().describe(
+    "Automation status filter: true = automated tests only, false = manual tests only. Omit to include both."
+  ),
+  aiGenerated: zod.boolean().optional().describe(
+    "AI generation flag: true = AI-generated test cycles 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, server returns its default set (NOTE: plannedStartDate and plannedEndDate are NOT in the default response — include them explicitly when needed). Available fields: key, summary, description, status, priority, assignee, reporter, isAutomated, plannedStartDate, plannedEndDate, labels, components, fixVersions, sprint, defectCount, estimatedTime, actualTime, created, updated. Example: ['key', 'summary', 'status', 'assignee', 'plannedStartDate', 'plannedEndDate']";
+const SearchTestCycleBody = zod.object({
+  filter: SearchTestCycleFilter.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). Default: 0."
+  ),
+  maxResults: zod.number().min(PAGINATION.MIN_ALLOWED_RESULTS).max(PAGINATION.MAX_ALLOWED_RESULTS_TEST_CYCLES).optional().default(PAGINATION.DEFAULT_MAX_RESULTS_TEST_CYCLES).describe(
+    `Number of results per page (URL query param). Default: ${PAGINATION.DEFAULT_MAX_RESULTS_TEST_CYCLES}. Maximum: ${PAGINATION.MAX_ALLOWED_RESULTS_TEST_CYCLES}. To page through results, increment startAt by ${PAGINATION.DEFAULT_MAX_RESULTS_TEST_CYCLES} until startAt >= total.`
+  ),
+  sort: zod.string().optional().default(SORT_DEFAULTS.TEST_CYCLES).describe(
+    `Sort pattern sent as a URL query param. Format: 'fieldName:order'. Default: '${SORT_DEFAULTS.TEST_CYCLES}'. Order values: 'asc' (lowest/oldest first) or 'desc' (highest/newest first). Sortable fields: key, summary, status, plannedStartDate, plannedEndDate, defectCount. Examples: 'key:asc', 'plannedStartDate:desc'`
+  )
+});
+const TestCycleStatusSchema = zod.looseObject({
+  id: zod.number().optional().describe("Numeric status ID"),
+  name: zod.string().optional().describe("Status display name e.g. 'In Progress'"),
+  color: zod.string().nullable().optional().describe("Hex color e.g. '#ffd351'")
+});
+const TestCyclePrioritySchema = zod.looseObject({
+  id: zod.number().optional().describe("Numeric priority ID"),
+  name: zod.string().optional().describe("Priority display name e.g. 'High'"),
+  color: zod.string().nullable().optional().describe("Hex color")
+});
+const TestCycleLabelSchema = zod.looseObject({
+  id: zod.number().optional(),
+  name: zod.string().optional()
+});
+const TestCycleComponentSchema = zod.looseObject({
+  id: zod.number().optional(),
+  name: zod.string().optional()
+});
+const TestCycleSearchItemSchema = zod.looseObject({
+  id: zod.string().describe("Internal UID of the test cycle"),
+  key: zod.string().describe("Human-readable key e.g. 'PROJ-TR-212'"),
+  projectId: zod.number().optional().describe("Numeric project ID"),
+  summary: zod.string().optional().describe("Test cycle name / title"),
+  description: zod.string().nullable().optional(),
+  status: TestCycleStatusSchema.optional().describe(
+    "Status object (empty {} when not requested)"
+  ),
+  priority: TestCyclePrioritySchema.optional().describe(
+    "Priority object (empty {} when not requested)"
+  ),
+  assignee: zod.string().nullable().optional().describe("Assignee Jira account ID, or null if unassigned"),
+  reporter: zod.string().nullable().optional(),
+  isAutomated: zod.boolean().optional(),
+  plannedStartDate: zod.string().nullable().optional(),
+  plannedEndDate: zod.string().nullable().optional(),
+  labels: zod.array(TestCycleLabelSchema).nullable().optional(),
+  components: zod.array(TestCycleComponentSchema).nullable().optional(),
+  fixVersions: zod.array(zod.any()).nullable().optional(),
+  sprint: zod.any().nullable().optional(),
+  defectCount: zod.number().nullable().optional(),
+  estimatedTime: zod.any().nullable().optional(),
+  actualTime: zod.any().nullable().optional(),
+  created: zod.any().optional(),
+  updated: zod.any().optional(),
+  archived: zod.boolean().optional()
+});
+const SearchTestCycleResponse = zod.object({
+  startAt: zod.number().describe("Offset of this page"),
+  maxResults: zod.number().describe("Page size used for this response"),
+  total: zod.number().describe("Total matching test cycles across all pages"),
+  data: zod.array(TestCycleSearchItemSchema).describe("Test cycles on this page")
+});
+export {
+  SearchTestCycleBody,
+  SearchTestCycleFilter,
+  SearchTestCycleResponse,
+  TestCycleSearchItemSchema
+};