@copado/agentia-cli 1.3.0 → 1.5.0-rc.0

package/dist/lib/job-get.js

@@ -1,4 +1,5 @@
 import {modules} from './runtime.js';
 const fetchJob = modules["job-get.js"]["fetchJob"]
 const fetchJobs = modules["job-get.js"]["fetchJobs"]
-export {fetchJob, fetchJobs};
+const resolveJobResultFileId = modules["job-get.js"]["resolveJobResultFileId"]
+export {fetchJob, fetchJobs, resolveJobResultFileId};

package/dist/lib/job-types.js

@@ -23,4 +23,5 @@ const normalizeJobResultFiles = modules["job-types.js"]["normalizeJobResultFiles
 const normalizeJobs = modules["job-types.js"]["normalizeJobs"]
 const normalizeJobsListPage = modules["job-types.js"]["normalizeJobsListPage"]
 const resolveJobStepForLog = modules["job-types.js"]["resolveJobStepForLog"]
-export {JOB_LIST_PAGE_SIZE_MAX, JOB_LIST_PAGE_SIZE_MIN, decodeJobResultFileBase64, formatJobDetail, formatJobOperationResult, formatJobResultFileTable, formatJobTable, jobEndpoint, jobKillEndpoint, jobListEndpoint, jobPauseEndpoint, jobResultFileContentEndpoint, jobResultFilesEndpoint, jobResultLogEndpoint, jobResumeEndpoint, jobRunEndpoint, jobStepResultId, normalizeJob, normalizeJobOperation, normalizeJobResultFileContent, normalizeJobResultFiles, normalizeJobs, normalizeJobsListPage, resolveJobStepForLog};
+const validateJobResultFileId = modules["job-types.js"]["validateJobResultFileId"]
+export {JOB_LIST_PAGE_SIZE_MAX, JOB_LIST_PAGE_SIZE_MIN, decodeJobResultFileBase64, formatJobDetail, formatJobOperationResult, formatJobResultFileTable, formatJobTable, jobEndpoint, jobKillEndpoint, jobListEndpoint, jobPauseEndpoint, jobResultFileContentEndpoint, jobResultFilesEndpoint, jobResultLogEndpoint, jobResumeEndpoint, jobRunEndpoint, jobStepResultId, normalizeJob, normalizeJobOperation, normalizeJobResultFileContent, normalizeJobResultFiles, normalizeJobs, normalizeJobsListPage, resolveJobStepForLog, validateJobResultFileId};

package/dist/lib/list-pagination.js

@@ -1,16 +1,21 @@
 import {modules} from './runtime.js';
+const EXPIRED_LIST_CURSOR_CATEGORY = modules["list-pagination.js"]["EXPIRED_LIST_CURSOR_CATEGORY"]
+const EXPIRED_LIST_CURSOR_WARNING = modules["list-pagination.js"]["EXPIRED_LIST_CURSOR_WARNING"]
 const LIST_PAGE_SIZE_MAX = modules["list-pagination.js"]["LIST_PAGE_SIZE_MAX"]
 const LIST_PAGE_SIZE_MIN = modules["list-pagination.js"]["LIST_PAGE_SIZE_MIN"]
 const appendListPaginationQueryParams = modules["list-pagination.js"]["appendListPaginationQueryParams"]
 const buildListPaginationQuery = modules["list-pagination.js"]["buildListPaginationQuery"]
 const buildPaginatedListResult = modules["list-pagination.js"]["buildPaginatedListResult"]
 const displayListPagination = modules["list-pagination.js"]["displayListPagination"]
+const emitPaginatedListWarnings = modules["list-pagination.js"]["emitPaginatedListWarnings"]
 const formatListContinuationHint = modules["list-pagination.js"]["formatListContinuationHint"]
 const formatListPageFooter = modules["list-pagination.js"]["formatListPageFooter"]
+const isExpiredListCursorError = modules["list-pagination.js"]["isExpiredListCursorError"]
 const listPaginationFlags = modules["list-pagination.js"]["listPaginationFlags"]
 const listPaginationZodFields = modules["list-pagination.js"]["listPaginationZodFields"]
 const mcpPaginatedListPayload = modules["list-pagination.js"]["mcpPaginatedListPayload"]
 const paginatedResultFromNestedData = modules["list-pagination.js"]["paginatedResultFromNestedData"]
 const paginatedResultFromPage = modules["list-pagination.js"]["paginatedResultFromPage"]
 const pickCursorPageMeta = modules["list-pagination.js"]["pickCursorPageMeta"]
-export {LIST_PAGE_SIZE_MAX, LIST_PAGE_SIZE_MIN, appendListPaginationQueryParams, buildListPaginationQuery, buildPaginatedListResult, displayListPagination, formatListContinuationHint, formatListPageFooter, listPaginationFlags, listPaginationZodFields, mcpPaginatedListPayload, paginatedResultFromNestedData, paginatedResultFromPage, pickCursorPageMeta};
+const withExpiredListCursorRetry = modules["list-pagination.js"]["withExpiredListCursorRetry"]
+export {EXPIRED_LIST_CURSOR_CATEGORY, EXPIRED_LIST_CURSOR_WARNING, LIST_PAGE_SIZE_MAX, LIST_PAGE_SIZE_MIN, appendListPaginationQueryParams, buildListPaginationQuery, buildPaginatedListResult, displayListPagination, emitPaginatedListWarnings, formatListContinuationHint, formatListPageFooter, isExpiredListCursorError, listPaginationFlags, listPaginationZodFields, mcpPaginatedListPayload, paginatedResultFromNestedData, paginatedResultFromPage, pickCursorPageMeta, withExpiredListCursorRetry};

package/dist/lib/local-quality-gates.js

@@ -2,10 +2,13 @@ import {modules} from './runtime.js';
 const AGENTIA_APEX_RERUN_FAILED_ENV = modules["local-quality-gates.js"]["AGENTIA_APEX_RERUN_FAILED_ENV"]
 const AGENTIA_APEX_RERUN_FAILED_FLAG = modules["local-quality-gates.js"]["AGENTIA_APEX_RERUN_FAILED_FLAG"]
 const AGENTIA_APEX_TEST_CLASSES_ENV = modules["local-quality-gates.js"]["AGENTIA_APEX_TEST_CLASSES_ENV"]
+const AGENTIA_BASE_BRANCH_ENV = modules["local-quality-gates.js"]["AGENTIA_BASE_BRANCH_ENV"]
+const AGENTIA_QUALITY_GATES_ACTIVE_ENV = modules["local-quality-gates.js"]["AGENTIA_QUALITY_GATES_ACTIVE_ENV"]
 const LocalQualityGatesError = modules["local-quality-gates.js"]["LocalQualityGatesError"]
 const QUALITY_GATES_SCRIPT_UNIX = modules["local-quality-gates.js"]["QUALITY_GATES_SCRIPT_UNIX"]
 const QUALITY_GATES_SCRIPT_WINDOWS = modules["local-quality-gates.js"]["QUALITY_GATES_SCRIPT_WINDOWS"]
 const buildQualityGatesCommand = modules["local-quality-gates.js"]["buildQualityGatesCommand"]
+const isInsideQualityGatesScript = modules["local-quality-gates.js"]["isInsideQualityGatesScript"]
 const parseQualityGatesEnvAssignments = modules["local-quality-gates.js"]["parseQualityGatesEnvAssignments"]
 const qualityGatesScriptName = modules["local-quality-gates.js"]["qualityGatesScriptName"]
 const resetLocalQualityGatesForTests = modules["local-quality-gates.js"]["resetLocalQualityGatesForTests"]
@@ -13,4 +16,4 @@ const resolveLocalQualityGatesScript = modules["local-quality-gates.js"]["resolv
 const runLocalQualityGates = modules["local-quality-gates.js"]["runLocalQualityGates"]
 const setLocalQualityGatesExistsSyncForTests = modules["local-quality-gates.js"]["setLocalQualityGatesExistsSyncForTests"]
 const setLocalQualityGatesSpawnForTests = modules["local-quality-gates.js"]["setLocalQualityGatesSpawnForTests"]
-export {AGENTIA_APEX_RERUN_FAILED_ENV, AGENTIA_APEX_RERUN_FAILED_FLAG, AGENTIA_APEX_TEST_CLASSES_ENV, LocalQualityGatesError, QUALITY_GATES_SCRIPT_UNIX, QUALITY_GATES_SCRIPT_WINDOWS, buildQualityGatesCommand, parseQualityGatesEnvAssignments, qualityGatesScriptName, resetLocalQualityGatesForTests, resolveLocalQualityGatesScript, runLocalQualityGates, setLocalQualityGatesExistsSyncForTests, setLocalQualityGatesSpawnForTests};
+export {AGENTIA_APEX_RERUN_FAILED_ENV, AGENTIA_APEX_RERUN_FAILED_FLAG, AGENTIA_APEX_TEST_CLASSES_ENV, AGENTIA_BASE_BRANCH_ENV, AGENTIA_QUALITY_GATES_ACTIVE_ENV, LocalQualityGatesError, QUALITY_GATES_SCRIPT_UNIX, QUALITY_GATES_SCRIPT_WINDOWS, buildQualityGatesCommand, isInsideQualityGatesScript, parseQualityGatesEnvAssignments, qualityGatesScriptName, resetLocalQualityGatesForTests, resolveLocalQualityGatesScript, runLocalQualityGates, setLocalQualityGatesExistsSyncForTests, setLocalQualityGatesSpawnForTests};

package/dist/lib/mcp/result.js

@@ -1,7 +1,8 @@
 import { createRequire } from 'node:module';
 import { runWithCicdConnectionOverride } from '../cicd-connection.js';
-import { createTransactionId, runWithGatewayTransactionContext } from '../cicd-gateway.js';
+import { createTransactionId, getGatewayTransactionOrigin, runWithGatewayTransactionContext } from '../cicd-gateway.js';
 import { recordMcpToolHistory } from '../command-history.js';
+import { publishIdeCommandCompleted } from '../ide-command-events.js';
 import { mcpCommandIdFromToolName, mcpToolNameFromHandler } from './command-id.js';
 import { redactErrorMessage, redactSecrets } from './redaction.js';
 const require = createRequire(import.meta.url);
@@ -12,10 +13,15 @@ export function runWithMcpToolContext(toolName, fn, options = {}) {
     const executionId = createTransactionId();
     const commandId = mcpCommandIdFromToolName(toolName);
     const startedAtMs = Date.now();
+    // Wrappers can nest; only the outermost call notifies the IDE.
+    const notifyIde = getGatewayTransactionOrigin() !== 'mcp';
     return runWithGatewayTransactionContext({ origin: 'mcp', referer: commandId, transactionId }, async () => {
         let error;
+        let toolFailed = false;
         try {
-            return await runWithCicdConnectionOverride(options.cicdConnection, fn);
+            const result = await runWithCicdConnectionOverride(options.cicdConnection, fn);
+            toolFailed = isMcpErrorResult(result);
+            return result;
         }
         catch (error_) {
             error = error_;
@@ -30,9 +36,19 @@ export function runWithMcpToolContext(toolName, fn, options = {}) {
                 startedAtMs,
                 transactionId,
             });
+            if (notifyIde) {
+                await publishIdeCommandCompleted({
+                    cliVersion: packageJson.version,
+                    commandId,
+                    error: error ?? (toolFailed ? new Error('MCP tool failed') : undefined),
+                });
+            }
         }
     });
 }
+function isMcpErrorResult(result) {
+    return typeof result === 'object' && result !== null && result.isError === true;
+}
 export function cicdConnectionFromToolArgs(args) {
     const first = args[0];
     if (first === null || typeof first !== 'object' || Array.isArray(first))

package/dist/lib/mcp/testing-browser-tools.js

@@ -2,7 +2,7 @@ import { mkdtemp } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { z } from 'zod';
-import { executeTestingLive, getTestingLiveHistory, getTestingLiveReports, getTestingLiveStatus, inspectTestingLive, saveTestingLiveScreenshot, setTestingLiveOptions, startTestingLive, stopTestingLive, } from '../testing-browser-operations.js';
+import { executeTestingLive, getTestingLiveHistory, getTestingLiveStatus, inspectTestingLive, saveTestingLiveScreenshot, setTestingLiveOptions, startTestingLive, stopTestingLive, } from '../testing-browser-operations.js';
 import { assertTestingLiveStopConfirmed, normalizeTestingLiveExecuteSource, normalizeTestingLiveRecorderOptions, normalizeTestingLiveStartScreen, shapeTestingLiveHistoryResult, } from '../testing-browser-requests.js';
 import { TESTING_LIVE_LIBRARIES } from '../testing-browser-types.js';
 import { safelyHandleTool } from './result.js';
@@ -62,15 +62,6 @@ async function testingBrowserScreenshot(args) {
         }),
     };
 }
-async function testingBrowserReports(args) {
-    return {
-        result: await getTestingLiveReports({
-            jobId: args.job,
-            projectId: args.project,
-            sessionId: args.sessionId,
-        }),
-    };
-}
 async function testingBrowserSetOptions(args) {
     return {
         result: await setTestingLiveOptions({
@@ -96,7 +87,6 @@ export const testingBrowserMcpHandlers = {
     testingBrowserExecute,
     testingBrowserHistory,
     testingBrowserInspect,
-    testingBrowserReports,
     testingBrowserScreenshot,
     testingBrowserSetOptions,
     testingBrowserStart,
@@ -167,11 +157,6 @@ export function registerTestingLiveMcpTools(server) {
         inputSchema: liveSessionSchema,
         title: 'Agentia Testing Browser Screenshot',
     }, (args) => safelyHandleTool(() => testingBrowserScreenshot(args)));
-    server.registerTool('agentia_testing_browser_reports', {
-        description: 'List browser session report metadata.',
-        inputSchema: liveSessionSchema,
-        title: 'Agentia Testing Browser Reports',
-    }, (args) => safelyHandleTool(() => testingBrowserReports(args)));
     server.registerTool('agentia_testing_browser_set_options', {
         description: 'Set CRT browser recorder options.',
         inputSchema: { recorder: liveRecorderOptionsSchema, ...liveSessionSchema },

package/dist/lib/mcp/tool-annotations.js

@@ -205,7 +205,6 @@ const READ_TOOLS = [
     'agentia_testing_job_schedule_get',
     'agentia_testing_browser_history',
     'agentia_testing_browser_inspect',
-    'agentia_testing_browser_reports',
     'agentia_testing_browser_screenshot',
     'agentia_testing_browser_status',
     'agentia_testing_project_get',

package/dist/lib/mcp/tools.js

@@ -5,7 +5,6 @@ import { buildMetadataContentRequest } from '../../commands/cicd/metadata/conten
 import { buildDependencyRequest, enrichDependencyResult, } from '../../commands/cicd/metadata/dependency/list.js';
 import { buildMetadataCompareRequest } from '../../commands/cicd/metadata/index/compare.js';
 import { buildMetadataIndexRequest } from '../../commands/cicd/metadata/list.js';
-import { AI_METADATA_ACTIONS, buildAiMetadataToolRequest, callAiMetadataTool, } from '../metadata-explore.js';
 import { assertRequired } from '../assert.js';
 import { applyAuthSet, getAiAuthStatus, getCicdAuthStatus, getCrtAuthStatus } from '../auth-config.js';
 import { CicdGateway } from '../cicd-gateway.js';
@@ -18,13 +17,14 @@ import { createEnvironmentCredential, listCredentials, resolveEnvironmentOrgType
 import { buildCreatePayload, buildMutationPayload, ENVIRONMENT_STRING_VALIDATION_KEYS, validateNonEmptyStringFields, } from '../environment-flags.js';
 import { fetchEnvironment, fetchEnvironments } from '../environment-get.js';
 import { DEFAULT_ENVIRONMENT_PLATFORM, DEFAULT_ENVIRONMENT_TYPE, ENVIRONMENT_TYPES, environmentEndpoint, } from '../environment-types.js';
+import { fetchFunctions } from '../function-list.js';
 import { executeLocalFunctionRun } from '../function-local-run.js';
-import { FUNCTION_LIST_TYPES, FUNCTION_RUNTIMES, functionEndpoint, functionResultEndpoint, functionResultLogEndpoint, functionRunEndpoint, functionsEndpoint, normalizeFunction, normalizeFunctionResultStatus, normalizeFunctionRunResult, normalizeFunctionsListPage, normalizeFunctionUpsertPayload, } from '../function-types.js';
-import { fetchJob, fetchJobs } from '../job-get.js';
-import { fetchPromotionQueue, removePromotionQueueItems } from '../promotion-queue.js';
+import { FUNCTION_LIST_TYPES, FUNCTION_RUNTIMES, functionEndpoint, functionResultEndpoint, functionResultLogEndpoint, functionRunEndpoint, functionsEndpoint, normalizeFunction, normalizeFunctionResultStatus, normalizeFunctionRunResult, normalizeFunctionUpsertPayload, } from '../function-types.js';
+import { fetchJob, fetchJobs, resolveJobResultFileId } from '../job-get.js';
 import { jobEndpoint, jobKillEndpoint, jobPauseEndpoint, jobResultFileContentEndpoint, jobResultFilesEndpoint, jobResultLogEndpoint, jobResumeEndpoint, jobRunEndpoint, normalizeJob, normalizeJobOperation, normalizeJobResultFileContent, normalizeJobResultFiles, resolveJobStepForLog, } from '../job-types.js';
 import { listPaginationZodFields, mcpPaginatedListPayload } from '../list-pagination.js';
 import { COMPARISON_MODES, CONTENT_SOURCES, contentResultToCompareSide, createUnifiedDiff, INDEX_SOURCES, MODULE_TYPES, ORDER_DIRECTIONS, PLATFORM_EXPERIENCES, RETRIEVE_MODES, sourceSideLabel, } from '../metadata-common.js';
+import { AI_METADATA_ACTIONS, buildAiMetadataToolRequest, callAiMetadataTool, } from '../metadata-explore.js';
 import { buildRefreshDeletedRequest, buildRefreshIndexRequest, refreshStatusEndpoint, resolveRefreshSourceFromEnv, } from '../metadata-refresh.js';
 import { NAVIGATION_RESOURCE_TYPES, resolveNavigationTarget } from '../navigation.js';
 import { configureNotification, NOTIFICATION_DESTINATION_TYPES, NOTIFICATION_EVENTS, NOTIFICATION_SUBSCRIPTIONS, withNotificationConfigureErrorTranslation, } from '../notifications-configure.js';
@@ -43,14 +43,18 @@ import { normalizeProject, projectEndpoint, projectsListEndpoint, } from '../pro
 import { buildPromotionConflictResolutionRequest, normalizePromotionConflicts, PROMOTION_CONFLICT_MODES, promotionConflictContentEndpoint, promotionConflictResolveEndpoint, promotionConflictsEndpoint, promotionConflictUndoEndpoint, withPromotionConflictErrorTranslation, } from '../promotion-conflicts.js';
 import { fetchPromotion, fetchPromotions } from '../promotion-get.js';
 import { buildPromotionManualTaskUpdatePayload, PROMOTION_MANUAL_TASK_STATUSES, promotionManualTaskEndpoint, } from '../promotion-job-steps.js';
+import { fetchPromotionQueue, removePromotionQueueItems } from '../promotion-queue.js';
 import { performPromotionResume, performPromotionRun, PROMOTION_OPERATIONS, PROMOTION_RUN_DEFAULT_TIMEOUT_SECONDS, } from '../promotion-run.js';
+import { fetchPromotionStatus } from '../promotion-status.js';
 import { REPOSITORY_STRING_VALIDATION_KEYS, validateNonEmptyStringFields as validateRepositoryNonEmptyStringFields, } from '../repository-flags.js';
-import { normalizeRepositoriesListPage, normalizeRepository, normalizeRepositoryValidateResult, repositoriesEndpoint, REPOSITORY_PROVIDERS, REPOSITORY_SOURCE_FORMATS, repositoryEndpoint, repositoryHttpsAuthEndpoint, repositoryResetEndpoint, repositorySshAuthEndpoint, repositoryValidateEndpoint, } from '../repository-types.js';
+import { fetchRepositories } from '../repository-list.js';
+import { normalizeRepository, normalizeRepositoryValidateResult, repositoriesEndpoint, REPOSITORY_PROVIDERS, REPOSITORY_SOURCE_FORMATS, repositoryEndpoint, repositoryHttpsAuthEndpoint, repositoryResetEndpoint, repositorySshAuthEndpoint, repositoryValidateEndpoint, } from '../repository-types.js';
 import { buildStageMutationPayload, validateStagePayload } from '../stage-flags.js';
 import { fetchStages } from '../stage-list.js';
 import { normalizePipelineStageConnection, normalizeStage, pipelineStageConnectionEndpoint, pipelineStageConnectionsEndpoint, STAGE_META_STAGE_SUGGESTIONS, stageEndpoint, stagesEndpoint, } from '../stage-types.js';
 import { buildTemplateDefaultsQuery } from '../template-flags.js';
-import { normalizeTemplate, normalizeTemplatesListPage, normalizeTemplateUpsertPayload, TEMPLATE_LIST_TYPES, templateDefaultsEndpoint, templateEndpoint, templatesEndpoint, } from '../template-types.js';
+import { fetchTemplates } from '../template-list.js';
+import { normalizeTemplate, normalizeTemplateUpsertPayload, TEMPLATE_LIST_TYPES, templateDefaultsEndpoint, templateEndpoint, } from '../template-types.js';
 import { getUserContext } from '../user-context.js';
 import { fetchUser } from '../user-get.js';
 import { DEFAULT_USER_ID } from '../user-types.js';
@@ -83,6 +87,9 @@ async function promotionList(args = {}) {
 async function promotionGet(args) {
     return { promotion: await fetchPromotion(assertRequired(args.id, 'id')) };
 }
+async function promotionStatus(args) {
+    return { status: await fetchPromotionStatus(assertRequired(args.id, 'id')) };
+}
 async function promotionRun(args) {
     const waitTimeout = args.waitTimeout ?? PROMOTION_RUN_DEFAULT_TIMEOUT_SECONDS;
     if (!Number.isInteger(waitTimeout) || waitTimeout <= 0) {
@@ -512,11 +519,7 @@ async function projectList(args = {}) {
     return mcpPaginatedListPayload('projects', await fetchProjects(args));
 }
 async function repositoryList(args = {}) {
-    const response = await CicdGateway.call({
-        endpoint: repositoriesEndpoint(args),
-        method: 'GET',
-    });
-    return mcpPaginatedListPayload('repositories', normalizeRepositoriesListPage(response));
+    return mcpPaginatedListPayload('repositories', await fetchRepositories(args));
 }
 async function repositoryGet(args) {
     const response = await CicdGateway.call({
@@ -605,11 +608,7 @@ async function repositoryValidate(args) {
     return { validation: normalizeRepositoryValidateResult(response) };
 }
 async function functionList(args = {}) {
-    const response = await CicdGateway.call({
-        endpoint: functionsEndpoint({ ...args, type: args.type ?? 'custom' }),
-        method: 'GET',
-    });
-    return mcpPaginatedListPayload('functions', normalizeFunctionsListPage(response));
+    return mcpPaginatedListPayload('functions', await fetchFunctions({ ...args, type: args.type ?? 'custom' }));
 }
 async function functionGet(args) {
     const response = await CicdGateway.call({
@@ -655,11 +654,7 @@ async function functionDelete(args) {
     return { apiName };
 }
 async function templateList(args = {}) {
-    const response = await CicdGateway.call({
-        endpoint: templatesEndpoint({ ...args, type: args.type ?? 'custom' }),
-        method: 'GET',
-    });
-    return mcpPaginatedListPayload('templates', normalizeTemplatesListPage(response));
+    return mcpPaginatedListPayload('templates', await fetchTemplates({ ...args, type: args.type ?? 'custom' }));
 }
 async function templateGet(args) {
     const response = await CicdGateway.call({
@@ -1119,8 +1114,9 @@ async function jobResultFileList(args) {
 }
 async function jobResultFileGet(args) {
     const resultId = assertRequired(args.resultId, 'resultId');
+    const fileId = await resolveJobResultFileId(resultId, assertRequired(args.fileId, 'fileId'));
     const response = await CicdGateway.call({
-        endpoint: jobResultFileContentEndpoint(resultId, assertRequired(args.fileId, 'fileId')),
+        endpoint: jobResultFileContentEndpoint(resultId, fileId),
         method: 'GET',
     });
     return { file: { ...normalizeJobResultFileContent(response), resultId } };
@@ -1321,8 +1317,6 @@ export const agentiaMcpToolHandlers = wrapMcpToolHandlers({
     jobList,
     jobLogGet,
     jobPause,
-    promotionQueueList,
-    promotionQueueRemove,
     jobResultFileGet,
     jobResultFileList,
     jobResume,
@@ -1366,6 +1360,8 @@ export const agentiaMcpToolHandlers = wrapMcpToolHandlers({
     promotionGet,
     promotionJobStepUpdate,
     promotionList,
+    promotionQueueList,
+    promotionQueueRemove,
     promotionRun,
     repositoryCreate,
     repositoryDelete,
@@ -1559,6 +1555,13 @@ export function registerAgentiaMcpTools(server) {
         },
         title: 'Agentia Promotion Get',
     }, (args) => safelyHandleTool(() => promotionGet(args)));
+    server.registerTool('agentia_promotion_status', {
+        description: 'Get actionable Copado promotion status: user stories, current job step, queue summary, and Manual Task or queue action-needed. Prefer this when the user asks whether a promotion is blocked or what is running.',
+        inputSchema: {
+            id: z.string().describe('Copado promotion Id.'),
+        },
+        title: 'Agentia Promotion Status',
+    }, (args) => safelyHandleTool(() => promotionStatus(args)));
     server.registerTool('agentia_promotion_run', {
         description: 'Preflight, start, and optionally wait for a Copado promotion. Can also resume an existing execution without starting a duplicate run.',
         inputSchema: {
@@ -2079,7 +2082,9 @@ export function registerAgentiaMcpTools(server) {
     server.registerTool('agentia_job_result_file_get', {
         description: 'Get a File linked to a Copado job Result.',
         inputSchema: {
-            fileId: z.string().describe('File ID returned by result-file list.'),
+            fileId: z
+                .string()
+                .describe('fileId returned by result-file list (068...); contentDocumentId (069...) is resolved automatically'),
             resultId: z.string().describe('Copado Result ID.'),
         },
         title: 'Agentia Job Result File Get',

package/dist/lib/mcp/work-tools.js

@@ -9,20 +9,22 @@ import { listPaginationZodFields, mcpPaginatedListPayload } from '../list-pagina
 import { LocalQualityGatesError, parseQualityGatesEnvAssignments, runLocalQualityGates, } from '../local-quality-gates.js';
 import { FULL_METADATA_SELECTION_TYPES_HELP } from '../nested-metadata-registry.js';
 import { PROJECT_DEFAULT_KEYS } from '../project-defaults.js';
-import { performPromotionRun, PROMOTION_RUN_DEFAULT_TIMEOUT_SECONDS, resolvePromotionIdForWorkItem, } from '../promotion-run.js';
-import { runWorkTestLocalQualityGates } from '../stock-quality-gates.js';
+import { performPromotionRun, PROMOTION_RUN_DEFAULT_TIMEOUT_SECONDS, PromotionRunValidationError, resolveOrCreatePromotionForWorkItem, } from '../promotion-run.js';
+import { isApexOnlySelection, resolveQualityGateSelection } from '../quality-gates.js';
+import { listLocalQualityGates, runWorkTestLocalQualityGates } from '../stock-quality-gates.js';
 import { getUserContext } from '../user-context.js';
 import { resolveWorkItemId } from '../work-active.js';
-import { planWorkApexTestRun, recordWorkApexTestOutcome } from '../work-apex-test-failures.js';
-import { DEFAULT_APEX_TEST_WAIT_MINUTES, parseApexTestClassNames, runWorkApexTests, skippedWorkApexTestResult, validateApexTestWaitMinutes, WorkApexTestError, } from '../work-apex-test.js';
+import { executeWorkApexTestRun } from '../work-apex-test-failures.js';
+import { DEFAULT_APEX_TEST_WAIT_MINUTES, parseApexTestClassNames, validateApexTestWaitMinutes, WorkApexTestError, } from '../work-apex-test.js';
 import { buildWorkCommitRequest, normalizeWorkCommitInput, performWorkCommit, resolveWorkCommitPlatformExperience, WORK_COMMIT_ACTIONS, WORK_COMMIT_CHANGES_HELP, WORK_COMMIT_DEFAULT_TIMEOUT_SECONDS, WORK_COMMIT_METADATA_CATEGORY_HELP, } from '../work-commit.js';
 import { buildWorkCreatePayload } from '../work-defaults.js';
 import { normalizeWorkCustomFields, validateWorkMutationPayload, WORK_LONG_TEXT_MAX_LENGTH, WORK_SHORT_TEXT_MAX_LENGTH, } from '../work-flags.js';
 import { fetchWorkItems, fetchWorkItemWithOptions } from '../work-get.js';
 import { performWorkLocalCommit } from '../work-local-commit.js';
-import { reportLocalQualityGatesFailure, reportLocalQualityGatesOutcome, } from '../work-local-run-tests.js';
+import { reportApexGateRun, reportLocalQualityGatesFailure, reportLocalQualityGatesOutcome, } from '../work-local-run-tests.js';
 import { capturingWorkPushHooks, performWorkPush, resolveActiveFeatureWorkItem, resolveWorkPushContext, resolveWorkPushNeed, uploadCapturedPublishLogsBestEffort, } from '../work-push.js';
 import { performWorkSetNone } from '../work-set-none.js';
+import { WorkPromoteValidationError } from '../work-promote.js';
 import { isWorkSetWarning, parseWorkSetSelection, toWorkSetWarningResult, writeWorkSetWarningSelection, } from '../work-set-selection.js';
 import { reportSubmitUserStoriesAheadBehind } from '../work-submit-ahead-behind.js';
 import { waitForPendingCommitJobIfNeeded } from '../work-submit-wait.js';
@@ -403,11 +405,35 @@ async function workTest(args = {}) {
         throw new Error('Cloud quality gates are not implemented yet. Pass local: true or omit cloud to run project-root quality gates.');
     }
     parseQualityGatesEnvAssignments(args.env);
+    const selection = resolveQualityGateSelection({ all: args.all, gates: args.gates });
+    if (args.listGates === true) {
+        const catalog = await listLocalQualityGates();
+        return { gates: catalog.gates, local: true, qualityGates: { ran: false, skipped: false } };
+    }
+    if (isApexOnlySelection(selection)) {
+        let apex;
+        try {
+            apex = await workTestApex({
+                apexTestClasses: args.apexTestClasses,
+                rerunFailedApexTests: args.rerunFailedApexTests,
+                wait: args.wait,
+            });
+        }
+        catch (error) {
+            if (error instanceof WorkApexTestError) {
+                await reportApexGateRunBestEffort(error.result, true);
+            }
+            throw error;
+        }
+        await reportApexGateRunBestEffort(apex, false);
+        return { apex, local: true, qualityGates: { ran: apex.skipped !== true, skipped: false } };
+    }
     let qualityGates;
     try {
         qualityGates = await runWorkTestLocalQualityGates({
             apexTestClasses: args.apexTestClasses,
             env: args.env,
+            gates: selection.gates,
             onOutput() {
                 // Capture output for the tool result/error; do not stream to the MCP stdio transport.
             },
@@ -442,28 +468,22 @@ async function workTest(args = {}) {
         qualityGates,
     };
 }
-async function workTestApex(args) {
-    const classNames = parseApexTestClassNames(args.apexTestClasses);
-    const waitMinutes = validateApexTestWaitMinutes(args.wait ?? DEFAULT_APEX_TEST_WAIT_MINUTES);
-    const plan = await planWorkApexTestRun({
-        requestedClassNames: classNames,
-        rerunFailed: args.rerunFailedApexTests === true,
-    });
-    if (plan.kind === 'skip') {
-        return skippedWorkApexTestResult(waitMinutes);
-    }
+async function reportApexGateRunBestEffort(result, failed) {
     try {
-        const result = await runWorkApexTests({ classNames: plan.classNames, waitMinutes });
-        await recordWorkApexTestOutcome({ failed: false, result, userStory: plan.userStory });
-        return result;
+        const { workItem } = await requireFeatureBranchWorkItem();
+        await reportApexGateRun({ failed, result, workItem });
     }
-    catch (error) {
-        if (error instanceof WorkApexTestError) {
-            await recordWorkApexTestOutcome({ failed: true, result: error.result, userStory: plan.userStory });
-        }
-        throw error;
+    catch {
+        // Best-effort reporting; never mask the Apex outcome.
     }
 }
+async function workTestApex(args) {
+    return executeWorkApexTestRun({
+        requestedClassNames: parseApexTestClassNames(args.apexTestClasses),
+        rerunFailed: args.rerunFailedApexTests === true,
+        waitMinutes: validateApexTestWaitMinutes(args.wait ?? DEFAULT_APEX_TEST_WAIT_MINUTES),
+    });
+}
 function hasMcpSimpleCommitArgs(args) {
     return (args.action !== undefined ||
         args.metadataCategory !== undefined ||
@@ -579,21 +599,37 @@ async function cloudPromote(args = {}) {
         throw new Error('waitTimeout must be a positive integer.');
     }
     const workItemId = await resolveWorkItemId(args.id);
-    const promotionId = await resolvePromotionIdForWorkItem(workItemId, args.promotionId);
-    const result = await performPromotionRun({
-        deploymentStepIds: args.deploymentStepIds,
-        hooks: {
-            log() { },
-            withSpinner: async (_message, action) => action(),
-        },
-        ignoredMetadata: args.ignoredMetadata,
-        operation: args.deploy === true ? 'merge_and_deploy' : 'merge',
-        promotionId,
-        recreatePromotionBranch: args.recreatePromotionBranch,
-        timeoutSeconds: waitTimeout,
-        wait: args.wait ?? true,
-    });
-    return { ...result, workItemId };
+    let createdPromotion;
+    try {
+        const resolved = await resolveOrCreatePromotionForWorkItem(workItemId, args.promotionId);
+        createdPromotion = resolved.createdPromotion;
+        const promotionId = resolved.promotionId;
+        const result = await performPromotionRun({
+            deploymentStepIds: args.deploymentStepIds,
+            hooks: {
+                log() { },
+                withSpinner: async (_message, action) => action(),
+            },
+            ignoredMetadata: args.ignoredMetadata,
+            operation: args.deploy === true ? 'merge_and_deploy' : 'merge',
+            promotionId,
+            recreatePromotionBranch: args.recreatePromotionBranch,
+            timeoutSeconds: waitTimeout,
+            wait: args.wait ?? true,
+        });
+        return {
+            ...result,
+            ...(createdPromotion === undefined ? {} : { createdPromotion }),
+            workItemId,
+        };
+    }
+    catch (error) {
+        // Map validation errors to plain Error messages for MCP clients.
+        if (error instanceof PromotionRunValidationError || error instanceof WorkPromoteValidationError) {
+            throw new Error(error.message);
+        }
+        throw error;
+    }
 }
 /** Compatibility alias of agentia_work_submit with done=true. Prefer agentia_work_submit({ done: true }). */
 async function workDone(args = {}) {
@@ -646,7 +682,7 @@ const workMutationSchema = {
     plannedPoints: z.number().int().optional().describe('Planned points.'),
     priority: z.number().int().optional().describe('Priority.'),
     project: z.string().optional().describe('Project ID.'),
-    recordType: z.string().optional().describe('Record type.'),
+    recordType: z.string().optional().describe('Record type DeveloperName.'),
     releaseId: z.string().optional().describe('Release ID.'),
     soThat: z.string().max(WORK_SHORT_TEXT_MAX_LENGTH).optional().describe('User story "so that" clause (maximum 255 characters).'),
     sourceCredential: z.string().optional().describe('Source credential ID. When set, sourceEnvironment is sent as null so Salesforce assigns the environment from the credential.'),
@@ -686,7 +722,7 @@ export function registerAgentiaMcpWorkTools(server) {
                 .boolean()
                 .optional()
                 .describe('When true, also include the Story committed metadata list as committedMetadata in the result.'),
-            id: z.string().optional().describe('User story Id. Defaults to the active work item from work set.'),
+            id: z.string().optional().describe('User story Id or name. Defaults to the active work item from work set.'),
         },
         title: 'Agentia Work Get',
     }, (args) => safelyHandleTool(() => workGet(args || {})));
@@ -699,14 +735,14 @@ export function registerAgentiaMcpWorkTools(server) {
         description: 'Update a Copado user story by Id via the CICD gateway. Omit Id to use the active work item from work set.',
         inputSchema: {
             ...workMutationSchema,
-            id: z.string().optional().describe('User story Id. Defaults to the active work item from work set.'),
+            id: z.string().optional().describe('User story Id or name. Defaults to the active work item from work set.'),
         },
         title: 'Agentia Work Update',
     }, (args) => safelyHandleTool(() => workUpdate(args)));
     server.registerTool('agentia_work_delete', {
         description: 'Delete a Copado user story by Id via the CICD gateway.',
         inputSchema: {
-            id: z.string().describe('User story Id.'),
+            id: z.string().describe('User story Id or name.'),
         },
         title: 'Agentia Work Delete',
     }, (args) => safelyHandleTool(() => workDelete(args)));
@@ -799,7 +835,7 @@ export function registerAgentiaMcpWorkTools(server) {
         promotionId: z
             .string()
             .optional()
-            .describe('Explicit 18-character Promotion ID when the User Story belongs to multiple promotions.'),
+            .describe('Explicit 18-character Promotion ID when the User Story belongs to multiple promotions. Used as is; never creates a promotion.'),
         recreatePromotionBranch: z.boolean().optional().describe('Recreate the promotion branch before execution.'),
         wait: z.boolean().optional().describe('Poll all created executions to terminal status. Defaults to true.'),
         waitTimeout: z
@@ -825,7 +861,7 @@ export function registerAgentiaMcpWorkTools(server) {
         title: 'Agentia Work Commit',
     }, (args) => safelyHandleTool(() => workCommit(args || {})));
     server.registerTool('agentia_cloud_promote', {
-        description: 'Resolve a Promotion from an explicit or active User Story, then preflight, start, and optionally wait for the cloud promotion.',
+        description: 'Resolve a Promotion from an explicit or active User Story, then preflight, start, and optionally wait for the cloud promotion. When no promotion contains the story, creates a forward Draft promotion, adds the story, then runs. Returns createdPromotion when a promotion was created. promotionId is used as is and never creates a promotion.',
         inputSchema: cloudPromoteInputSchema,
         title: 'Agentia Cloud Promote',
     }, (args) => safelyHandleTool(() => cloudPromote(args || {})));
@@ -853,8 +889,12 @@ export function registerAgentiaMcpWorkTools(server) {
         title: 'Agentia Work Submit',
     }, (args) => safelyHandleTool(() => workSubmit(args || {})));
     server.registerTool('agentia_work_test', {
-        description: 'Run quality gates for the current work item. With local=true (the default when cloud is omitted), runs project-root .agentia_quality_gates.sh (macOS/Linux) or .agentia_quality_gates.cmd (Windows) when present. When no project script exists, warns and runs the stock Agentia setup sample from a temporary file. With cloud=true, runs remote Copado quality gates (not implemented yet). Optional env is an array of NAME=value strings injected into the quality-gate script environment (same as CLI -e/--env).',
+        description: 'Run quality gates for the current work item. With local=true (the default when cloud is omitted), runs project-root .agentia_quality_gates.sh (macOS/Linux) or .agentia_quality_gates.cmd (Windows) when present. When no project script exists, warns and runs the stock Agentia setup sample from a temporary file. With cloud=true, runs remote Copado quality gates (not implemented yet). By default every gate runs; pass gates to run a subset (scripts declare gates with `# agentia-gate: <id> - <description>`) or listGates to list them. Optional env is an array of NAME=value strings injected into the quality-gate script environment (same as CLI -e/--env).',
         inputSchema: {
+            all: z
+                .boolean()
+                .optional()
+                .describe('Run every gate in the quality-gates script (default when gates is omitted). Mutually exclusive with gates.'),
             apexTestClasses: z
                 .string()
                 .optional()
@@ -867,6 +907,14 @@ export function registerAgentiaMcpWorkTools(server) {
                 .array(z.string())
                 .optional()
                 .describe('Extra environment variables for the quality-gate script as NAME=value strings (same as CLI -e/--env). Applied before reserved AGENTIA_APEX_* variables.'),
+            gates: z
+                .array(z.string())
+                .optional()
+                .describe('Run only these gate ids (standard: apex, lint, lwc; or custom ids declared in the script). Exported as AGENTIA_GATES. Only ["apex"] skips the script and runs the Apex tests directly.'),
+            listGates: z
+                .boolean()
+                .optional()
+                .describe('List the gates declared in the quality-gates script (or the stock sample) and return without running anything.'),
             local: z
                 .boolean()
                 .optional()
@@ -874,12 +922,17 @@ export function registerAgentiaMcpWorkTools(server) {
             rerunFailedApexTests: z
                 .boolean()
                 .optional()
-                .describe('Pass AGENTIA_APEX_RERUN_FAILED=--rerun-failed-apex-tests to local quality gates so sample scripts forward that flag to work test apex.'),
+                .describe('Pass AGENTIA_APEX_RERUN_FAILED=--rerun-failed-apex-tests to local quality gates so sample scripts forward that flag to the apex gate.'),
+            wait: z
+                .number()
+                .int()
+                .optional()
+                .describe(`Minutes to wait for Apex test results when gates is ["apex"]. Defaults to ${DEFAULT_APEX_TEST_WAIT_MINUTES}.`),
         },
         title: 'Agentia Work Test',
     }, (args) => safelyHandleTool(() => workTest(args || {})));
     server.registerTool('agentia_work_test_apex', {
-        description: 'Run specified Apex test classes via Salesforce CLI (`sf apex run test`) with code coverage. Usually run from project-root local quality gates (`.agentia_quality_gates.sh` / `.agentia_quality_gates.cmd`) when those scripts are configured. When apexTestClasses is omitted or empty, skips Salesforce CLI and returns skipped=true. Failed runs save `.agentia/apex.tests.<user-story>.json`; successful runs delete that file. rerunFailedApexTests runs the previously failed classes. Returns the test-run summary when the run passes. Failed runs include failing tests with Message and StackTrace.',
+        description: 'Run specified Apex test classes via Salesforce CLI (`sf apex run test`) with code coverage. Equivalent to agentia_work_test with gates ["apex"]. When apexTestClasses is omitted or empty, skips Salesforce CLI and returns skipped=true. Failed runs save `.agentia/apex.tests.<user-story>.json`; successful runs delete that file. rerunFailedApexTests runs the previously failed classes. Returns the test-run summary when the run passes. Failed runs include failing tests with Message and StackTrace.',
         inputSchema: {
             apexTestClasses: z
                 .string()

package/dist/lib/promotion-run.js

@@ -23,6 +23,8 @@ const promotionRunErrorJson = modules["promotion-run.js"]["promotionRunErrorJson
 const promotionValidateResolutionEndpoint = modules["promotion-run.js"]["promotionValidateResolutionEndpoint"]
 const requirePromotionId = modules["promotion-run.js"]["requirePromotionId"]
 const resetPromotionRunSleepForTests = modules["promotion-run.js"]["resetPromotionRunSleepForTests"]
+const resolveOrCreatePromotionForWorkItem = modules["promotion-run.js"]["resolveOrCreatePromotionForWorkItem"]
 const resolvePromotionIdForWorkItem = modules["promotion-run.js"]["resolvePromotionIdForWorkItem"]
 const setPromotionRunSleepForTests = modules["promotion-run.js"]["setPromotionRunSleepForTests"]
-export {NoPromotionForUserStoryError, PROMOTION_OPERATIONS, PROMOTION_RUN_DEFAULT_TIMEOUT_SECONDS, PromotionRunIncompleteResponseError, PromotionRunJobFailedError, PromotionRunTimeoutError, PromotionRunValidationError, assertPromotionContextReady, formatPromotionRunResult, isPromotionRunExecutionError, parseIgnoredMetadataJson, performPromotionResume, performPromotionRun, promotionContextEndpoint, promotionDeploymentStepsEndpoint, promotionIgnoredMetadataEndpoint, promotionJobMonitorEndpoint, promotionResumeEndpoint, promotionRunDetailEndpoint, promotionRunEndpoint, promotionRunErrorJson, promotionValidateResolutionEndpoint, requirePromotionId, resetPromotionRunSleepForTests, resolvePromotionIdForWorkItem, setPromotionRunSleepForTests};
+const waitForPromotionDeploymentExecution = modules["promotion-run.js"]["waitForPromotionDeploymentExecution"]
+export {NoPromotionForUserStoryError, PROMOTION_OPERATIONS, PROMOTION_RUN_DEFAULT_TIMEOUT_SECONDS, PromotionRunIncompleteResponseError, PromotionRunJobFailedError, PromotionRunTimeoutError, PromotionRunValidationError, assertPromotionContextReady, formatPromotionRunResult, isPromotionRunExecutionError, parseIgnoredMetadataJson, performPromotionResume, performPromotionRun, promotionContextEndpoint, promotionDeploymentStepsEndpoint, promotionIgnoredMetadataEndpoint, promotionJobMonitorEndpoint, promotionResumeEndpoint, promotionRunDetailEndpoint, promotionRunEndpoint, promotionRunErrorJson, promotionValidateResolutionEndpoint, requirePromotionId, resetPromotionRunSleepForTests, resolveOrCreatePromotionForWorkItem, resolvePromotionIdForWorkItem, setPromotionRunSleepForTests, waitForPromotionDeploymentExecution};

package/dist/lib/promotion-status.js

@@ -0,0 +1,12 @@
+import {modules} from './runtime.js';
+const buildPromotionActionNeeded = modules["promotion-status.js"]["buildPromotionActionNeeded"]
+const buildPromotionStatusSnapshot = modules["promotion-status.js"]["buildPromotionStatusSnapshot"]
+const fetchPromotionStatus = modules["promotion-status.js"]["fetchPromotionStatus"]
+const formatPromotionStatus = modules["promotion-status.js"]["formatPromotionStatus"]
+const isManualTaskStep = modules["promotion-status.js"]["isManualTaskStep"]
+const isPendingManualTaskStep = modules["promotion-status.js"]["isPendingManualTaskStep"]
+const pickCurrentJobStep = modules["promotion-status.js"]["pickCurrentJobStep"]
+const pickPendingManualTaskStep = modules["promotion-status.js"]["pickPendingManualTaskStep"]
+const resolvePromotionStatusJobId = modules["promotion-status.js"]["resolvePromotionStatusJobId"]
+const toPromotionStatusStep = modules["promotion-status.js"]["toPromotionStatusStep"]
+export {buildPromotionActionNeeded, buildPromotionStatusSnapshot, fetchPromotionStatus, formatPromotionStatus, isManualTaskStep, isPendingManualTaskStep, pickCurrentJobStep, pickPendingManualTaskStep, resolvePromotionStatusJobId, toPromotionStatusStep};

package/dist/lib/quality-gates.js

@@ -0,0 +1,13 @@
+import {modules} from './runtime.js';
+const AGENTIA_GATES_ALL = modules["quality-gates.js"]["AGENTIA_GATES_ALL"]
+const AGENTIA_GATES_ENV = modules["quality-gates.js"]["AGENTIA_GATES_ENV"]
+const APEX_QUALITY_GATE_ID = modules["quality-gates.js"]["APEX_QUALITY_GATE_ID"]
+const STANDARD_QUALITY_GATE_IDS = modules["quality-gates.js"]["STANDARD_QUALITY_GATE_IDS"]
+const UnknownQualityGateError = modules["quality-gates.js"]["UnknownQualityGateError"]
+const formatDeclaredQualityGates = modules["quality-gates.js"]["formatDeclaredQualityGates"]
+const isApexOnlySelection = modules["quality-gates.js"]["isApexOnlySelection"]
+const parseDeclaredQualityGates = modules["quality-gates.js"]["parseDeclaredQualityGates"]
+const parseQualityGateIds = modules["quality-gates.js"]["parseQualityGateIds"]
+const qualityGatesEnvValue = modules["quality-gates.js"]["qualityGatesEnvValue"]
+const resolveQualityGateSelection = modules["quality-gates.js"]["resolveQualityGateSelection"]
+export {AGENTIA_GATES_ALL, AGENTIA_GATES_ENV, APEX_QUALITY_GATE_ID, STANDARD_QUALITY_GATE_IDS, UnknownQualityGateError, formatDeclaredQualityGates, isApexOnlySelection, parseDeclaredQualityGates, parseQualityGateIds, qualityGatesEnvValue, resolveQualityGateSelection};

package/dist/lib/repository-list.js

@@ -0,0 +1,3 @@
+import {modules} from './runtime.js';
+const fetchRepositories = modules["repository-list.js"]["fetchRepositories"]
+export {fetchRepositories};